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 and USDC deposits are accounted for in one USD balance. Trading requests use the exact market symbol returned by GET /markets, currently USD-NGN.

Authentication

string
required
Your API key with Read scope

Request Examples

Response

boolean
required
Indicates if the request was successful
string
required
Human-readable response message
object
required
Balances wrapper object
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