Guides
Guides

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.


Wallet Management

ActionMethodEndpointDescription
Check spot balanceGET/wallet/fundsGet your spot wallet balance including total, rewards, withdrawable
Check futures balancePOST/futures/fundsGet futures wallet balance and available transfer amount
Transfer fundsPOST/wallet/futures/transferMove funds between spot and futures wallets

Asset Discovery

ActionMethodEndpointDescription
List all assetsGET/futuresList all tradable futures contracts with sorting/pagination
Get asset detailsGET/futures/{asset_id}Get detailed contract specs (min/max contract, leverage limits, fees)

Leverage Management

ActionMethodEndpointDescription
Get leverageGET/futures/{asset_id}/leverageCheck current leverage and margin type for an asset
Set leveragePOST/futures/{asset_id}/leverageSet leverage (within asset's min/max range) and margin type

Order Management

ActionMethodEndpointDescription
Place orderPOST/futures/{asset_id}/orderCreate market or limit order (LONG/SHORT) with optional SL/TP
View open ordersGET/futures/ordersList all your open orders
Get order detailsGET/futures/orders/{order_id}Retrieve details of a specific order
Cancel orderDELETE/futures/orders/{order_id}Cancel an open order
Amend orderPATCH/futures/orders/{order_id}Modify an existing order (price, quantity, etc.)
Order historyGET/futures/orders/historyView your historical orders

Position Management

ActionMethodEndpointDescription
View open positionsGET/futures/positionsGet all open positions with entry price, quantity, leverage, PnL
Close positionPOST/futures/positions/{position_id}/closeFully close a position
Partial closePOST/futures/positions/{position_id}/close/partialClose a portion of your position
Reverse positionPOST/futures/positions/{position_id}/reverseSwitch from LONG to SHORT or vice versa
Position historyGET/futures/positions/historyView your closed position history

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 existing stop-loss or take-profit levels

Monitoring & History

ActionMethodEndpointDescription
Fee historyGET/futures/fee/historyRetrieve your trading fee history

Quick Trading Workflow

Here's a typical trading workflow using the APIs above:

  1. Check balanceGET /wallet/funds to see available funds
  2. Transfer to futuresPOST /wallet/futures/transfer if needed
  3. Discover assetsGET /futures to find tradable instruments
  4. Set leveragePOST /futures/{asset_id}/leverage for your chosen asset
  5. Place orderPOST /futures/{asset_id}/order to open a position
  6. Monitor positionGET /futures/positions to track PnL
  7. Manage riskPOST /futures/positions/{position_id}/riskorder to set SL/TP
  8. Close positionPOST /futures/positions/{position_id}/close or use partial close

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