Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Address

Get cross-chain address balances

Gets balance information for a specific address across all enabled EVM keyring chains

For EVM keyring wallets, this endpoint returns the balance of a specific receive address across all derived child wallets on different chains (e.g., ETH, Polygon, BSC). The same address exists on multiple chains due to shared key material.

get/api/v2/wallet/{walletId}/address/{address}/crosschainbalances

Path parameters

walletIdstring required
Example:59cd72485007a239fb00282ed480da1f
addressstring required
Example:2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS

The address to check across chains

Query parameters

includeAllChainsboolean

Include all chains in the EVM keyring, even if the address doesn't exist on them yet. When true, returns placeholder entries with empty id field and zero balances for chains where the address hasn't been created.

Response

OK

countnumber required

Total count of addresses returned

Example response

{
  "addresses": [
    {
      "id": "59cd72485007a239fb00282ed480da1f",
      "coin": "btc",
      "wallet": "59cd72485007a239fb00282ed480da1f",
      "address": "2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS",
      "label": "Bob's Hot Wallet Address",
      "token": "usdc",
      "balance": {
        "balanceString": "500000",
        "confirmedBalanceString": "400000",
        "spendableBalanceString": "40000",
        "balance": 50000
      }
    }
  ]
}