Skip to main content
GET
/
v2
/
farcaster
/
user
/
balance
Token balance
curl --request GET \
  --url https://api.neynar.com/v2/farcaster/user/balance/ \
  --header 'x-api-key: <api-key>'
{
  "user_balance": {
    "address_balances": [
      {
        "token_balances": [
          {
            "balance": {
              "in_token": "<string>",
              "in_usdc": "<string>"
            },
            "token": {
              "name": "<string>",
              "symbol": "<string>",
              "address": "<string>",
              "decimals": 123
            }
          }
        ],
        "verified_address": {
          "address": "<string>"
        }
      }
    ],
    "user": {
      "fid": 3,
      "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "display_name": "<string>",
      "pfp_url": "<string>",
      "score": 123,
      "username": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.neynar.com/llms.txt

Use this file to discover all available pages before exploring further.

Fetch User Balance

Node.js SDK

🔗 SDK Method: fetchUserBalance 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

Query Parameters

fid
integer
required

FID of the user to fetch

Required range: x >= 1
networks
enum<string>[]
required

Comma separated list of networks to fetch balances for

A blockchain network e.g. "ethereum", "optimism", "base", "arbitrum"

Available options:
ethereum,
optimism,
base,
arbitrum

Response

Success

user_balance
object