Trade
Perps
Lend
Dashboard
DocsFutures Trading Endpoints
Place, cancel, and manage leveraged orders for perpetual futures.
Base URL: https://fapi.bond.xyz — All trading endpoints require authentication.
Place New Order
POST
/fapi/v1/order
Send in a new futures order. Security: TRADE. Weight: 1 on order rate limit, 0 on IP rate limit.
symbol
STRING
YES
Trading pair symbol
side
ENUM
YES
BUY or SELL
type
ENUM
YES
LIMIT, MARKET, POST_ONLY, STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET
timeInForce
ENUM
NO
GTC, IOC, FOK, GTD
quantity
DECIMAL
NO
Cannot be sent with closePosition=true
price
DECIMAL
NO
Order price
newClientOrderId
STRING
NO
Unique ID among open orders. Auto-generated if not sent.
newOrderRespType
ENUM
NO
ACK, RESULT. Default: ACK
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp in ms
// ACK response { "symbol": "BTCUSDC", "product_id": 2, "orderId": 28, "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP", "transactTime": 1507725176595 } // RESULT response { "symbol": "BTCUSDC", "orderId": 28, "status": "FILLED", "price": "0.00000000", "origQty": "10.00000000", "executedQty": "10.00000000", "type": "MARKET", "side": "SELL" }
Order Type Requirements
LIMIT
timeInForce, quantity, price
MARKET
quantity
POST_ONLY
quantity, price
Cancel Order
DELETE
/fapi/v1/order
Cancel an active order. Security: TRADE. Weight: 1. 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
newClientOrderId
STRING
NO
Unique ID for cancel. Auto-generated by default.
cancelRestrictions
ENUM
NO
ONLY_NEW or ONLY_PARTIALLY_FILLED
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp
{ "symbol": "BTCUSDC", "origClientOrderId": "myOrder1", "orderId": 4, "status": "CANCELED", "timeInForce": "GTC", "type": "LIMIT", "side": "BUY" }
Cancel All Open Orders
DELETE
/fapi/v1/openOrders
Cancel all active orders on a symbol. Security: TRADE. Weight: 1.
symbol
STRING
YES
Trading pair symbol
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp
Change Leverage
POST
/fapi/v1/leverage
Change initial leverage for a specific symbol market. Security: TRADE. Weight: 1.
symbol
STRING
YES
Trading pair symbol
leverage
LONG
YES
Target initial leverage: integer from 1 to 125
recvWindow
LONG
NO
Request validity window
timestamp
LONG
YES
Current timestamp
{ "leverage": 21, "symbol": "BTCUSDC" }
Order Types Reference
LIMIT
Standard limit order
MARKET
Market order at best available price
STOP
Stop-limit order (triggers at stopPrice)
STOP_MARKET
Stop-market order
TAKE_PROFIT
Take-profit limit order
TAKE_PROFIT_MARKET
Take-profit market order
TRAILING_STOP_MARKET
Trailing stop order with callback rate
Time in Force
GTC
Good Till Cancel - remains active until filled or canceled
IOC
Immediate or Cancel - fills immediately or cancels unfilled portion
FOK
Fill or Kill - must be filled completely or canceled entirely
GTD
Good Till Date - remains active until specified date
Position Modes
One-way Mode (default): Single position per symbol. positionSide = BOTH. BUY increases long, SELL reduces.
Hedge Mode: Allows simultaneous long and short positions. Must specify positionSide as LONG or SHORT.