Guides
Guides

Trading API quick reference

Trading API quick reference

This guide provides a quick overview of all trading actions and their corresponding API endpoints. Use this as a reference to quickly find the right endpoint for your trading workflow.

Currency parameter. Add trade_currency (USDT or INR) to operate in a given currency — query parameter on GET, body field on POST/PATCH/DELETE. Omitted defaults to USDT. The spot balance endpoint uses currency instead of trade_currency. INR transfers use a dedicated endpoint (see below).

Wallet Management

ActionMethodEndpointDescription
Check spot balanceGET/wallet/fundsGet spot wallet balance. Use ?currency=INR for the INR spot wallet.
Check futures balanceGET/futures/fundsGet futures wallet balance. Use ?trade_currency=INR for INR.
Transfer funds (USDT)POST/wallet/futures/transferMove USDT between spot and futures wallets.
Transfer funds (INR)POST/futures/transfers/inrMove INR between INR spot and INR futures wallets.
Futures transactionsGET/futures/transactionsList futures transfers (DEPOSIT/WITHDRAW). Use ?trade_currency=INR.

Asset Discovery

ActionMethodEndpointDescription
List all assetsGET/futuresList all tradable futures contracts with sorting/pagination.
Get asset detailsGET/futures/{asset_id}Get detailed contract specs. Unchanged for USDT and INR.

Leverage Management

ActionMethodEndpointDescription
Get leverageGET/futures/{asset_id}/leverageCheck leverage/margin type. Per (asset, currency); add trade_currency.
Set leveragePOST/futures/{asset_id}/leverageSet leverage per (asset, currency); add trade_currency in body.

Order Management

ActionMethodEndpointDescription
Place orderPOST/futures/{asset_id}/orderCreate market or limit order. Add trade_currency in body for INR.
View open ordersGET/futures/ordersList open orders for one currency (?trade_currency=INR).
Get order detailsGET/futures/orders/{order_id}Retrieve a specific order (carries trade_currency, hedge_rate).
Cancel orderDELETE/futures/orders/{order_id}Cancel an open order.
Amend orderPATCH/futures/orders/{order_id}Modify an order. Requires order_price and quantity.
Order historyGET/futures/orders/historyHistorical orders for one currency (?trade_currency=INR).

Position Management

ActionMethodEndpointDescription
View open positionsGET/futures/positionsOpen positions for one currency (?trade_currency=INR).
Close positionPOST/futures/positions/{position_id}/closeFully close a position.
Partial closePOST/futures/positions/{position_id}/close/partialClose a portion of a position.
Reverse positionPOST/futures/positions/{position_id}/reverseSwitch from LONG to SHORT or vice versa.
Add/Reduce marginPOST/futures/positions/{position_id}/add-marginAdjust margin (in the position's currency).
Liquidation priceGET/futures/positions/{position_id}/liq-priceEstimated liquidation price (USDT).
Position historyGET/futures/positions/historyClosed positions for one currency (?trade_currency=INR).

Risk Management (Stop-Loss & Take-Profit)

ActionMethodEndpointDescription
Set SL/TPPOST/futures/positions/{position_id}/riskorderAttach stop-loss and/or take-profit to a position.
Edit SL/TPPATCH/futures/positions/{position_id}/riskorderModify SL/TP. Requires stoploss_order_id / takeprofit_order_id.

Monitoring & History

ActionMethodEndpointDescription
Fee historyGET/futures/fee/historyTrading/funding fee history for one currency (?trade_currency=INR).

Quick Trading Workflow

  1. Check balanceGET /wallet/funds (?currency=INR for INR spot)
  2. Transfer to futuresPOST /wallet/futures/transfer (USDT) or POST /futures/transfers/inr (INR)
  3. Discover assetsGET /futures
  4. Set leveragePOST /futures/{asset_id}/leverage (add trade_currency for INR)
  5. Place orderPOST /futures/{asset_id}/order (add trade_currency for INR)
  6. Monitor positionGET /futures/positions (?trade_currency=INR)
  7. Manage riskPOST /futures/positions/{position_id}/riskorder
  8. Close positionPOST /futures/positions/{position_id}/close or partial close

For detailed API documentation, parameters, and examples, refer to the API Reference section.