Balance
Query account balances
Get Futures Balance
GET /v1/futures/balance
Authorization: Bearer <token>Response:
{
"ok": true,
"balances": [
{
"asset": "USDT",
"walletBalance": "1250.50",
"unrealizedProfit": "26.75",
"marginBalance": "1277.25",
"availableBalance": "980.30"
}
]
}| Field | Description |
|---|---|
walletBalance | Total balance including realized PnL |
unrealizedProfit | Unrealized PnL from open positions |
marginBalance | walletBalance + unrealizedProfit |
availableBalance | Free margin available for new orders |
Get Trade History
GET /v1/futures/myTrades?symbol=BTCUSDT&subAccountId=34696153
Authorization: Bearer <token>Query Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Trading pair |
subAccountId | string | No | Sub-account ID |
fromId | number | No | Start from specific trade ID |
Response:
{
"ok": true,
"data": [
{
"symbol": "BTCUSDT",
"id": 12345,
"orderId": 67890,
"price": "71000.00",
"qty": "0.01",
"realizedPnl": "5.23",
"side": "BUY",
"time": 1711756800000
}
]
}