Fetch User Information

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

farcaster

user

bulk-by-address

By Eth or Sol addresses

curl --request GET \
  --url https://api.neynar.com/v2/farcaster/user/bulk-by-address/ \
  --header 'x-api-key: <api-key>'

{}

Node.js SDK

🔗 SDK Method: fetchBulkUsersByEthOrSolAddress Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.

Authorizations

x-api-key

string

header

default:NEYNAR_API_DOCS

required

API key to authorize requests

Headers

x-neynar-experimental

boolean

default:false

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

Query Parameters

addresses

string

required

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

Example:

"0xa6a8736f18f383f1cc2d938576933e5ea7df01a1,0x7cac817861e5c3384753403fb6c0c556c204b1ce"

address_types

enum<string>[]

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.

Available options:

custody_address,

verified_address

viewer_fid

integer

Required range: x >= 1

Response

Success

{key}

User · object[]

Show child attributes

By FIDs (Farcaster IDs)By custody-address

⌘I

Documentation Index

​See related guide: User by wallet address

​Node.js SDK

Authorizations

Headers

Query Parameters

Response

See related guide: User by wallet address

Node.js SDK