Skip to main content
POST
/
exchange
/
balance
Get your cryptocurrency exchange balances
curl --request POST \
  --url https://openapiv1.coinstats.app/exchange/balance \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "connectionFields": {
    "apiKey": "your_binance_api_key_here",
    "apiSecret": "your_binance_api_secret_here"
  },
  "connectionId": "binance",
  "name": "My Binance Portfolio"
}
'
{
  "balances": [
    {
      "coinId": "popcat",
      "amount": 0.00342,
      "price": 0.25946,
      "priceBtc": 0.0000023571544854315866
    }
  ],
  "portfolio": {
    "id": "618f0bb0f2cf07dce25bc5007750bf1646825509bb63519bd491ab6a56daa419",
    "status": "syncing",
    "connectionId": "bybit",
    "name": "My Binance Portfolio"
  }
}
10 credits per request
  • Real-time balance information
  • All coins and tokens in your account
  • Current value in USD and BTC
  • Available and locked amounts
  • connectionId: Exchange identifier (e.g., “binance”, “coinbase”)
  • connectionFields: Exchange API credentials
    • apiKey: Your exchange API key
    • apiSecret: Your exchange API secret
  • name: Custom name for the portfolio
  • Use read-only API keys when possible
  • Keep your API credentials secure
  • Enable IP restrictions on exchange side

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.

Body

application/json
​
connectionFields
object
required

Authentication credentials required to connect to the exchange. This object should contain the API key, secret, and any additional authentication fields from Exchanges request

Example:
{
  "apiKey": "your_binance_api_key_here",
  "apiSecret": "your_binance_api_secret_here"
}
​
connectionId
string
required

The connectionId for the cryptocurrency exchange platform from Exchanges request

Example:

"binance"

​
name
string

Name for the portfolio

Example:

"My Binance Portfolio"

Response

Get exchange balance

​
balances
object[]
required

Array of cryptocurrency balances in the exchange account

​
portfolio
object
required

Portfolio information including sync status and connection details