Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dubupay.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
​
success
boolean
Always true for successful responses.
​
data
array
List of balance objects, one per 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"
    }
  ]
}