Skip to main content

​
Overview

Query token balances held by a wallet address. Supports multi-chain filtering, scam token removal, cursor-based pagination, and optional resolution of full token metadata.
  • Filter by specific networks or tokens
  • Include or exclude native assets
  • Remove scam tokens automatically
  • Sort by balance amount or USD value
  • Cursor-based pagination for large portfolios
  • Optionally resolve full token details and first-held timestamps

​
Returns

​
balances
BalancesResponse!
See BalancesResponse and Balance for full type details.

​
Arguments

​
input
BalancesInput
See BalancesInput for full details.

​
Example

{
  balances(input: {
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    networks: [1]
    limit: 10
    removeScams: true
    sortBy: USD_VALUE
    sortDirection: DESC
  }) {
    items {
      tokenAddress
      networkId
      balance
      shiftedBalance
      balanceUsd
      tokenPriceUsd
      liquidityUsd
      token {
        name
        symbol
        decimals
        address
        networkId
      }
    }
    cursor
  }
}

​
Pagination

Use the cursor from the response to fetch the next page: 
{
  balances(input: {
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    limit: 10
    cursor: "eyJvZmZzZXQiOjEwfQ=="
  }) {
    items {
      tokenAddress
      shiftedBalance
      balanceUsd
      token { symbol }
    }
    cursor
  }
}

​
Playground