> ## 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.
# Get Wallet Balance Many
> Get cryptocurrency balances for multiple wallets
**40** credits per requestIn **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**](/multipliers)
* 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.
## OpenAPI
````yaml /api-reference/openapi.json get /v1/wallet/balance/many
openapi: 3.0.0
info:
title: CoinStats Public API
description: >-
CoinStats Public API — programmatic access to market data, news, NFTs,
wallets, exchange connections, and user portfolios. Authenticate every
request with the `X-API-KEY` header (or an OAuth Bearer token in the
`Authorization` header). Generate keys at https://openapi.coinstats.app.
version: '1.0'
contact: {}
servers:
- url: https://openapiv1.coinstats.app
security: []
tags:
- name: CoinStats
description: ''
- name: Market Data
description: >-
The Market Data section of the API provides endpoints to access a wide
range of market-related information, including cryptocurrency coins,
ticker data, and fiat currency rates. This category offers comprehensive
data to help users monitor and analyze the cryptocurrency market, track
prices, and gain insights into market trends
- name: News
description: >-
The News section of the API allows you to access news articles and updates
related to cryptocurrencies and the blockchain industry. It provides
valuable information from various sources to keep you informed about the
latest developments
- name: NFTs
description: >-
The NFT section of the API provides endpoints to interact with
Non-Fungible Tokens (NFTs), which are unique digital assets stored on a
blockchain. These endpoints allow you to retrieve information about NFTs,
including collections, assets, trending NFTs, and specific assets
associated with wallet addresses.
- name: Wallet Data
description: >-
The Wallet section of the API provides a comprehensive set of endpoints to
manage and interact with wallets. It enables users to retrieve wallet
balances, monitor syncing status, fetch transaction data, and synchronize
wallet information with the blockchain. By integrating these endpoints
into your application, you can offer robust wallet functionality to your
users.
- name: Exchange Connection
description: >-
The Exchange Connection section of the API provides a comprehensive set of
endpoints to manage and interact with exchanges. It enables users to
retrieve exchange balances, monitor syncing status, fetch transaction
data. By integrating these endpoints into your application, you can offer
robust exchange portfolio tracking functionality to your users.
- name: User Portfolio
description: >-
The Portfolio section of the API provides a comprehensive set of endpoints
to manage and interact with Share Portfolios. It enables users to retrieve
current Portfolio Coins and Transactions.
- name: Usage
description: The Usage section provides account-level API usage data.
- name: Status
description: The Status section provides API availability checks.
paths:
/v1/wallet/balance/many:
get:
tags:
- Wallet Data
summary: Get cryptocurrency balances for multiple wallets
operationId: get-wallet-balance-many
parameters:
- name: address
required: false
in: query
description: >-
The wallet address for which the balance is being queried. Must be a
valid string representing an EVM-compatible wallet address.
schema:
example: '0x1234567890abcdef1234567890abcdef12345678'
type: string
- name: blockchain
required: false
in: query
description: >-
The identifier of connection from
[/wallet/blockchains](/openapi/get-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.
schema:
default: all
example: ethereum,polygon,binance_smart
type: string
- name: wallets
required: false
in: query
description: >-
Comma-separated list of wallet addresses in format
"[connectionId](/openapi/get-blockchains):address".
schema:
example: >-
ethereum:0x1234567890abcdef1234567890abcdef12345678,all:0x4567890abcdef1234567890abcdef1234567890abc
type: string
responses:
'200':
description: Get wallets balance
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/WalletBalancesResponse'
'400':
description: Bad Request
content:
application/json:
example:
statusCode: 400
message: Bad Request
requestId: 11111111-2222-3333-4444-555555555555
path:
'401':
description: Unauthorized
content:
application/json:
example:
statusCode: 401
message: Unauthorized
requestId: 11111111-2222-3333-4444-555555555555
path:
'403':
description: Forbidden
content:
application/json:
example:
statusCode: 403
message: Forbidden
requestId: 11111111-2222-3333-4444-555555555555
path:
'404':
description: Not Found
content:
application/json:
example:
statusCode: 404
message: Not Found
requestId: 11111111-2222-3333-4444-555555555555
path:
'409':
description: Conflict (for some endpoints)
content:
application/json:
example:
statusCode: 409
message: Transactions not synced
requestId: 11111111-2222-3333-4444-555555555555
path:
'429':
description: Too Many Requests
content:
application/json:
example:
statusCode: 429
message: Rate limit exceeded
requestId: 11111111-2222-3333-4444-555555555555
path:
'503':
description: Service Unavailable
content:
application/json:
example:
statusCode: 503
message: Service Unavailable. Please Contact Support
security:
- X-API-KEY: []
components:
schemas:
WalletBalancesResponse:
type: object
properties:
blockchain:
type: string
description: The blockchain network name
example: ethereum
address:
type: string
description: The wallet address that was queried
example: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
connectionId:
type: string
description: The blockchain network identifier that was used in the query
example: ethereum
balances:
description: Array of cryptocurrency balances found in the wallet
type: array
items:
$ref: '#/components/schemas/WalletBalanceResponseCoinDto'
required:
- blockchain
- balances
WalletBalanceResponseCoinDto:
type: object
properties:
chain:
type: string
description: The blockchain network where this token exists
example: ethereum
connectionId:
type: string
description: The blockchain network identifier that was used in the query
example: ethereum
coinId:
type: string
description: Unique identifier for the cryptocurrency
example: ethereum
amount:
type: number
description: The total balance amount of this cryptocurrency in the wallet
example: 1.5
name:
type: string
description: Full name of the cryptocurrency
example: Ethereum
symbol:
type: string
description: Trading symbol of the cryptocurrency
example: ETH
price:
type: number
description: Current price in USD
example: 2000.5
priceBtc:
type: number
description: Current price in BTC
example: 0.05
imgUrl:
type: string
description: URL of the cryptocurrency logo image
example: https://static.coinstats.app/coins/1650455629727.png
pCh24h:
type: number
description: Price change percentage in the last 24 hours
example: 5.25
rank:
type: number
description: Market cap rank of the cryptocurrency
example: 2
volume:
type: number
description: 24-hour trading volume in USD
example: 15000000000
decimals:
type: number
description: >-
Number of decimal places for token precision (mainly for ERC20
tokens)
example: 18
contractAddress:
type: string
description: Smart contract address for tokens (e.g. ERC20, BEP20)
example: '0xdac17f958d2ee523a2206206994597c13d831ec7'
required:
- coinId
- amount
- name
- symbol
- price
- priceBtc
- imgUrl
- pCh24h
- rank
- volume
securitySchemes:
X-API-KEY:
type: apiKey
in: header
name: X-API-KEY
description: >-
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.
````