By Eth or Sol addresses

get https://api.neynar.com/v2/farcaster/user/bulk-by-address

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.

📘
See related guide: User by wallet address

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.neynar.com/v2/farcaster/user/bulk-by-address \
3
     --header 'accept: application/json' \
4
     --header 'x-api-key: NEYNAR_API_DOCS' \
5
     --header 'x-neynar-experimental: false'


xxxxxxxxxx
95
}
1
{
2
  "additionalProp": [
3
    {
4
      "object": "user",
5
      "fid": 3,
6
      "username": "string",
7
      "display_name": "string",
8
      "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
9
      "pfp_url": "string",
10
      "profile": {
11
        "bio": {
12
          "text": "string",
13
          "mentioned_profiles": [
14
            {
15
              "object": "user_dehydrated",
16
              "fid": 3,
17
              "username": "string",
18
              "display_name": "string",
19
              "pfp_url": "string",
20
              "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
21
            }
22
          ],
23
          "mentioned_profiles_ranges": [
24
            {
25
              "start": 0,
26
              "end": 0
27
            }
28
          ],
29
          "mentioned_channels": [

📘See related guide: User by wallet address

200Successful operation.

400Bad Request

404Resource not found

📘
See related guide: User by wallet address