---
title: "Token balance"
method: GET
path: "/v2/farcaster/user/balance/"
tags: ["Onchain"]
---

# Token balance

`GET /v2/farcaster/user/balance/`

Fetches the token balances of a user given their FID

## Query parameters

- `fid` integer, required
- `networks` string[], required

## Response `200`

Success

- BalanceResponse
  - `user_balance` object
    - `address_balances` AddressBalance[], required
      - `object` 'address_balance', required
      - `token_balances` TokenBalance[], required
        - `balance` object, required
          - `in_token` string, required — The balance in the token
          - `in_usdc` string, required — The balance in USDC
        - `object` 'token_balance', required
        - `token` object, required
          - `address` string — The contract address of the token (omitted for native token)
          - `decimals` integer — The number of decimals the token uses
          - `name` string, required — The token name e.g. "Ethereum"
          - `object` 'token', required
          - `symbol` string, required — The token symbol e.g. "ETH"
      - `verified_address` object, required
        - `address` string, required — The wallet address
        - `network` 'ethereum' | 'optimism' | 'base' | 'arbitrum' | 'robinhood', required — A blockchain network e.g. "ethereum", "optimism", "base", "arbitrum", "robinhood"
    - `object` 'user_balance', required
    - `user` UserDehydrated, required
      - `custody_address` string — Ethereum address
      - `display_name` string, nullable
      - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
      - `object` 'user_dehydrated', required
      - `pfp_url` string, nullable
      - `score` number
      - `username` string

## Other responses

- `400` — Bad Request
- `404` — Resource not found
- `500` — Server Error

---

[API](https://skmtc.net/neynar/apis/neynar-api.md) · [All operations](https://skmtc.net/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neynar/neynar-api/versions/dbb91bfb0d1a/schema)