Ctrl+K

Get cross-chain address balances

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

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.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • addressstringRequired
    The address to check across chains
    Example: 2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS
    Max length: <= 250 characters

Query Parameters

  • includeAllChainsbooleanDefault: false
    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.

200 Response

addresses array[object] required
List of addresses across all chains in the EVM keyring with their balances
id string required
Platform public ID for the address
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
coin string required
The coin/chain for this address
Example: null
wallet string required
Wallet ID containing this address
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
address string required
The address string (same across chains in an EVM keyring)
Max length: <= 250 characters
Example: null
chain number required
Chain index (0 for receive addresses)
Allowed values: 0 1 10 11 20 21 30 31 40 41
index number required
Address index within the chain
label string
User-defined label for this address
Max length: <= 250 characters
Example: Bob's Hot Wallet Address
token string
Token identifier if this is a token address
Example: usdc
balance object
Balance information for this address
count number required
Total count of addresses returned

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id