Token balance

Fetches the token balances of a user given their FID

GET /v2/farcaster/user/balance

Token balance

cURL

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

200

{}

Fetch User Balance

Related tutorial: User balances directly w/ FID

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

200

application/json

Success

user_balance · object

Show child attributes