Trade
Perps
Lend
Dashboard
DocsFutures Account Endpoints
Position management, balances, orders, trades, and commission rates for perpetual futures.
Base URL: https://fapi.bond.xyz — All account endpoints require authentication (USER_DATA).
Get Account Balance
GET
/fapi/v1/balance
Query futures account balance information. Weight: 5.
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp in milliseconds
[ { "asset": "USDC", "balance": "122607.35137903", "updateTime": 1617939110373 } ]
Get Account Information
GET
/fapi/v1/account
Get current account information including positions and assets. Weight: 5.
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp in milliseconds
{ "assets": [ { "asset": "USDC", "walletBalance": "103.12345678" } ], "positions": [ { "symbol": "BTCUSDCPERP", "positionAmt": "1.000", "marginAmt": "17.84" } ] }
Get Position Information
GET
/fapi/v1/positionRisk
Get current position information. Weight: 5.
symbol
STRING
NO
Trading pair symbol
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp in milliseconds
[ { "entryPrice": "6490.48971", "breakEvenPrice": "6490.48971", "marginType": "isolated", "isolatedMargin": "100.000", "leverage": "10", "liquidationPrice": "6900.39281094", "markPrice": "6679.50671178", "positionAmt": "0.000", "symbol": "BTCUSDT", "unRealizedProfit": "0.00000000" } ]
Query Order
GET
/fapi/v1/order
Check an order's status. Weight: 4. Either orderId or origClientOrderId must be sent.
symbol
STRING
YES
Trading pair symbol
orderId
LONG
NO
Order ID
origClientOrderId
STRING
NO
Original client order ID
recvWindow
DECIMAL
NO
Max 60000
timestamp
LONG
YES
Current timestamp in ms
Get Open Orders
GET
/fapi/v1/openOrders
Get all open orders. Weight: 6 for single symbol; 80 when symbol omitted.
symbol
STRING
NO
Trading pair symbol
recvWindow
DECIMAL
NO
Max 60000
timestamp
LONG
YES
Current timestamp in ms
Get All Orders
GET
/fapi/v1/allOrders
Get all account orders: active, canceled, or filled. Weight: 20.
symbol
STRING
YES
Trading pair symbol
orderId
LONG
NO
Order ID to start from
startTime
LONG
NO
Start time in ms
endTime
LONG
NO
End time in ms
limit
INT
NO
Default 500; max 1000
timestamp
LONG
YES
Current timestamp in ms
Get Trade List
GET
/fapi/v3/myTrades
Get trades for a specific account and symbol. Weight: 20. Time between startTime and endTime max 24 hours.
symbol
STRING
YES
Trading pair symbol
orderId
LONG
NO
Only with symbol
startTime
LONG
NO
Start time in ms
endTime
LONG
NO
End time in ms
fromId
LONG
NO
TradeId to fetch from
limit
INT
NO
Default 500; max 1000
timestamp
LONG
YES
Current timestamp in ms
[ { "symbol": "BTCUSDCPERP", "id": 28457, "orderId": 100234, "price": "4.00000100", "qty": "12.00000000", "time": 1499865549590, "isBuyer": true, "isMaker": false } ]
Get Commission Rate
GET
/fapi/v1/commissionRate
Get user commission rate for a specific symbol. Weight: 20.
symbol
STRING
YES
Trading pair symbol
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp in ms
{ "symbol": "BTCUSDC", "makerCommissionRate": "0.0002", "takerCommissionRate": "0.0004" }
Get Income History
GET
/fapi/v1/income
Query income history (e.g., funding fees). Weight: 30. Only contains data for the last three months.
symbol
STRING
NO
Trading pair symbol
incomeType
STRING
NO
e.g., FUNDING_FEE
startTime
LONG
NO
Timestamp in ms
endTime
LONG
NO
Timestamp in ms
limit
INT
NO
Default 100; max 1000
timestamp
LONG
YES
Current timestamp in ms
[ { "symbol": "BTCUSDCPERP", "incomeType": "FUNDING_FEE", "income": "-0.37500000", "asset": "USDC", "time": 1570608000000 } ]