Skip to main content
GET
/
chains
/
balances
/
{address}
Get wallet balances across all chains
curl --request GET \
  --url https://api.chainrails.io/api/v1/chains/balances/{address} \
  --header 'Authorization: Bearer <token>'
{
  "BASE_MAINNET": [
    {
      "symbol": "USDC",
      "balance": "1000000000",
      "decimals": 6,
      "formatted": "1000.0",
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  ],
  "ETHEREUM_MAINNET": [
    {
      "symbol": "ETH",
      "balance": "5000000000000000000",
      "decimals": 18,
      "formatted": "5.0",
      "address": "0x0000000000000000000000000000000000000000"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Path Parameters

​
address
string
required

Wallet address to check balances for

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

Query Parameters

​
includeZeroBalances
boolean

Include tokens with zero balance in response

Example:

false

​
network
enum<string>

Filter by network type (mainnet or testnet)

Available options:
mainnet,
testnet
​
chainType
enum<string>

Filter by chain type (EVM or STARKNET)

Available options:
EVM,
STARKNET

Response

Wallet balances retrieved successfully

​
{key}
object[]