Positions
Endpoints to query and manage your futures positions, including retrieving open and closed positions, placing and amending risk orders, and closing or reversing positions.
The Positions section lets you monitor and manage your open and past trades. You can fetch all current open positions along with their entry price, quantity, leverage and margin; set or update stop‑loss and take‑profit orders; reverse a position; close part of a position; and retrieve your closed position history. Each sub‑page addresses a different aspect of position management.
Currency. List endpoints (
/futures/positions,/futures/positions/history) taketrade_currencyas a query parameter, default toUSDT, return one currency per call, and tag each position with itstrade_currency. Per-position actions (add-margin, riskorder, partial close, reverse, close, liq-price) act on the position UUID, which already identifies the position's currency. Margin amounts and PnL are in the position's currency; entry and liquidation prices remain USDT. INR positions return the FX rate asentry_hedge_rate/exit_hedge_rate.