v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
User

By Eth or Sol addresses

Fetches all users based on multiple Ethereum or Solana addresses.

Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.

A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users. You can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.

get/v2/farcaster/user/bulk-by-address/

Query parameters

addressesstring required
Example:0xa6a8736f18f383f1cc2d938576933e5ea7df01a1,0x7cac817861e5c3384753403fb6c0c556c204b1ce

Comma separated list of Ethereum or Solana addresses, up to 350 at a time

address_typesstring[]

Customize which address types the request should search for. This is a comma-separated string that can include the following values: 'custody_address' and 'verified_address'. By default api returns both. To select multiple types, use a comma-separated list of these values.

viewer_fidinteger

Headers

x-neynar-experimentalboolean

Enables experimental features including filtering based on the Neynar score. See docs for more details.

Response

Success

BulkUsersByAddressResponse required