GET /trading/balances — trading account balances

The balances endpoint gives you a real-time snapshot of your trading account. For each asset held in your account, you receive three figures: the amount available to place new orders, the amount locked in open orders, and the combined total. Use this endpoint before placing orders to confirm you have sufficient funds. All trading routes require authentication. Pass your API key in the X-Api-Key header or a valid JWT in the Authorization: Bearer header.

Request

curl https://api.dubupay.com/api/v1/trading/balances \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"

Response

A successful response returns 200 OK with a data array containing one object per asset.

boolean

Always true for successful responses.

array

List of balance objects, one per asset.

Show Balance object

string

The asset ticker, e.g. USDT, USDC, NGN.

string

The amount available to trade or withdraw. Formatted as a decimal string to preserve precision.

string

The amount currently locked in open or partially-filled orders.

string

The sum of available and locked. Represents your full holding for this asset.

Example response

{
  "success": true,
  "data": [
    {
      "asset": "USDT",
      "available": "500.00",
      "locked": "100.00",
      "total": "600.00"
    },
    {
      "asset": "NGN",
      "available": "750000.00",
      "locked": "0.00",
      "total": "750000.00"
    }
  ]
}

Overview

Auth

Payments

Trading

Commerce

Webhooks

GET /trading/balances — trading account balances

Request

Response

Example response