Skip to main content
GET
/
wallet
/
balance
Get cryptocurrency balances for any blockchain wallet
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/balance \
  --header 'X-API-KEY: <api-key>'
[
  {
    "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
  • Token balances across multiple networks
  • NFT holdings
  • Current USD values
  • Historical transactions
  • address: Wallet address to query
  • connectionId: Blockchain network(s) to check
    • Single network (e.g., “ethereum”)
    • Multiple networks (“ethereum,polygon”)
    • “all” for all supported networks
  • Multi-chain support
  • ERC20 token detection
  • NFT balance tracking
  • Historical data access

Authorizations

​
X-API-KEY
string
header
required

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

Query Parameters

​
address
string
required

The blockchain wallet address to query balances for

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

​
connectionId
string
required

The blockchain network identifier to query.

Example:

"ethereum"

Response

Get wallet balance

​
coinId
string
required

Unique identifier for the cryptocurrency

Example:

"ethereum"

​
amount
number
required

The total balance amount of this cryptocurrency in the wallet

Example:

1.5

​
name
string
required

Full name of the cryptocurrency

Example:

"Ethereum"

​
symbol
string
required

Trading symbol of the cryptocurrency

Example:

"ETH"

​
price
number
required

Current price in USD

Example:

2000.5

​
priceBtc
number
required

Current price in BTC

Example:

0.05

​
imgUrl
string
required

URL of the cryptocurrency logo image

Example:

"https://static.coinstats.app/coins/1650455629727.png"

​
pCh24h
number
required

Price change percentage in the last 24 hours

Example:

5.25

​
rank
number
required

Market cap rank of the cryptocurrency

Example:

2

​
volume
number
required

24-hour trading volume in USD

Example:

15000000000

​
chain
string

The blockchain network where this token exists

Example:

"ethereum"

​
decimals
number

Number of decimal places for token precision (mainly for ERC20 tokens)

Example:

18

​
contractAddress
string

Smart contract address for tokens (e.g. ERC20, BEP20)

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

⌘I