---
title: "Token Balances by Wallet Address"
method: GET
path: "/onchain/wallets/{address}/balances"
---

# Token Balances by Wallet Address

`GET /onchain/wallets/{address}/balances`

## Request

- Base URL: `https://pro-api.coingecko.com/api/v3`
- URL: `https://pro-api.coingecko.com/api/v3/onchain/wallets/{address}/balances`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query the token balances of a wallet address across networks

## Path parameters

- `address` string, required

## Query parameters

- `networks` string, required
- `sort` 'value_usd_desc' | 'value_usd_asc'
- `token_type` 'native' | 'non_native'
- `value_usd_min` number
- `reserve_in_usd_min` number
- `page` integer
- `per_page` integer

## Response `200`

Wallet token balances data

- WalletTokenBalances
  - `data` object, required
    - `id` string, required: Wallet address
    - `type` string, required: Response type
    - `attributes` object, required
      - `wallet_address` string, required: Wallet address queried
      - `total_value_usd` string, required: Total value of matching holdings in USD, across the requested networks only
      - `total_holdings` integer, required: Number of matching holdings across the requested networks only
      - `networks` object[], required: Value and holding count per network, listing only networks holding a matching balance
        - `network` string, required: Network ID
        - `value_usd` string, required: Total value of matching holdings on this network in USD
        - `holdings` integer, required: Number of matching holdings on this network
        - `last_updated_at` string, date-time, required: Last updated timestamp
      - `balances` object[], required: Token holdings, one entry per token
        - `network` string, required: Network ID
        - `address` string, required: Token contract address
        - `token_type` string, required: Token type, such as native, erc20 or spl
        - `name` string, required: Token name
        - `symbol` string, required: Token symbol
        - `decimals` integer, required: Token decimals
        - `coingecko_coin_id` string, nullable, required: CoinGecko coin ID
        - `balance_raw` string, required: Token balance in the smallest unit, before decimals are applied
        - `balance` string, nullable, required: Token balance at full precision
        - `price_usd` string, nullable, required: Token price in USD
        - `value_usd` string, nullable, required: Value of the holding in USD
        - `h24_price_change_percentage` string, nullable, required: 24hr price change percentage
        - `total_reserve_in_usd` string, nullable, required: Total reserve in USD across all pools of the token

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-api/revisions/dd263cff468b?raw)