Skip to main content
GET
Get Balances

Overview

Get the current balance for all currencies in your Pro account. This endpoint requires authentication with an API key that has Read scope.
Unified Balance: USDT, USDC, and USD are all mapped to a single unified USD balance. When you trade with any of these symbols (USDT-NGN, USDC-NGN, or USD-NGN), they all use the same USD balance.

Authentication

X-Api-Key
string
required
Your API key with Read scope

Request Examples

Response

success
boolean
required
Indicates if the request was successful
message
string
required
Human-readable response message
data
object
required
Balances wrapper object
timestamp
string
ISO 8601 timestamp of the response

Success Response

Error Responses

401 Unauthorized

Common causes:
  • Missing X-Api-Key header
  • Invalid API key format
  • API key has been revoked

403 Forbidden

Common causes:
  • API key does not have Read scope
  • User account is suspended

Rate Limits

  • 100 requests per minute per API key
  • Requires Read scope

Next Steps

Place Order

Use your balance to place trades

List Orders

View your open and historical orders