Skip to main content
GET
/
wallet
/
balances
Get cryptocurrency balances for multiple wallets
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/balances \
  --header 'X-API-KEY: <api-key>'
[
  {
    "blockchain": "ethereum",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "connectionId": "ethereum",
    "balances": [
      {
        "chain": "ethereum",
        "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,
        "decimals": 18,
        "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    ]
  }
]
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 “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 across multiple networks
  • Token balances across multiple addresses

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

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"

​
networks
string
default:all

Specifies the blockchain networks to query for the wallet balance. Can be a single network (e.g., "ethereum") or a comma-separated list of networks (e.g., "ethereum,polygon,binance_smart"). If not provided, the default is "all" supported networks.

Example:

"ethereum,polygon,binance_smart"

​
wallets
string

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

Example:

"ethereum:0x1234567890abcdef1234567890abcdef12345678,all:0x4567890abcdef1234567890abcdef1234567890abc"

Response

Get wallet balances

​
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"

⌘I