Skip to main content
GET
Get cryptocurrency balances for multiple wallets
40 credits per request
In Query field “networks”: credits are multiplied by the number of values.
If the value of “networks” in Query is “all”, multiplier is 400 credits.
In Query field “blockchain”: credits are multiplied by the number of values.
If the value of “blockchain” in Query is “all”, multiplier is 400 credits.
In Query field “wallets”: credits are multiplied by the number of values.
If the value of “wallets” in Query is “all”, multiplier is 400 credits.
Multipliers can be applied multiple times.

  • Token balances grouped by blockchain (and per wallet, when querying multiple)
  • Current USD price, BTC price, and 24h change per token
  • Token contract addresses and decimals (ERC20-style tokens)
  • Either:
    • wallets: comma-separated “connectionId:address” pairs (a connectionId of “all” or “forceall” is also accepted), or
    • address plus blockchain (single, comma-separated, “all”, or “forceall”)
  • “all” forces the top-tier EVM chains — ethereum, binacesmartchain, base-wallet, polygon-wallet, arbitrum-wallet, optimism-wallet, avalanche-wallet, hyperevm-wallet, monad-wallet, plasma-wallet — and bounds other chains by a per-chain latency limit, so in rare cases a slow chain may be omitted. Use “forceall” instead to wait for every supported chain regardless of latency.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

address
string

The wallet address for which the balance is being queried. Must be a valid string representing an EVM-compatible wallet address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

blockchain
string
default:all

The identifier of connection from /wallet/blockchains call response. Specifies the blockchain networks to query for the wallet balance. Can be a single network (e.g., "ethereum"), a comma-separated list of networks (e.g., "ethereum,polygon,binance_smart"), "all", or "forceall". With "all", the top-tier EVM chains (ethereum, binacesmartchain, base-wallet, polygon-wallet, arbitrum-wallet, optimism-wallet, avalanche-wallet, hyperevm-wallet, monad-wallet, plasma-wallet) are always included while other chains are subject to a per-chain latency limit and may be skipped. Use "forceall" to wait for every supported chain regardless of latency.

Example:

"ethereum,polygon,binance_smart"

wallets
string

Comma-separated list of wallet addresses in format "connectionId:address".

Example:

"ethereum:0x1234567890abcdef1234567890abcdef12345678,all:0x4567890abcdef1234567890abcdef1234567890abc"

Response

Get wallets balance

blockchain
string
required

The blockchain network name

Example:

"ethereum"

balances
object[]
required

Array of cryptocurrency balances found in the wallet

address
string

The wallet address that was queried

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

connectionId
string

The blockchain network identifier that was used in the query

Example:

"ethereum"