Skip to main content
GET
/
wallet
/
balance
/
many
Get cryptocurrency balances for multiple wallets
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/balance/many \
  --header 'X-API-KEY: <api-key>'
[
  {
    "blockchain": "ethereum",
    "balances": [
      {
        "coinId": "ethereum",
        "amount": 1.5,
        "name": "Ethereum",
        "symbol": "ETH",
        "price": 2000.5,
        "priceBtc": 0.05,
        "imgUrl": "https://static.coinstats.app/coins/1650455629727.png",
        "pCh24h": 5.25,
        "rank": 2,
        "volume": 15000000000,
        "chain": "ethereum",
        "connectionId": "ethereum",
        "decimals": 18,
        "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    ],
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "connectionId": "ethereum"
  }
]

Documentation Index

Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
Detailed multipliers explanation
  • 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"