Get All Positions Info

#Get All Positions Info

Returns the authenticated account's position rows together with account-level margin and collateral metrics.

#Endpoint

GET /v1/positions

Mainnet: GET https://api.orderly.org/v1/positions\\ Testnet: GET https://testnet-api.orderly.org/v1/positions

Rate limit: 30 requests per 10 seconds per user.

#Headers

• orderly-timestamp (string, required): Signed request timestamp in milliseconds.
• orderly-account-id (string, required): Authenticated account ID.
• orderly-key (string, required): Public key used to sign the request.
• orderly-signature (string, required): Signature of the request payload.

#Parameters

No query or path parameters.

#Response

HTTP 200 returns success, data, and server timestamp. The account-level data includes required numeric values: current_margin_ratio_with_orders, free_collateral, initial_margin_ratio, initial_margin_ratio_with_orders, maintenance_margin_ratio, maintenance_margin_ratio_with_orders, margin_ratio, open_margin_ratio, total_collateral_value, and total_pnl_24_h. account_value is also returned.

data.rows is an array of positions. Each row may include numeric IMR_withdraw_orders, MMR_with_orders, average_open_price, cost_position, est_liq_price, fee_24_h, imr, last_sum_unitary_funding, mark_price, mmr, pending_long_qty, pending_short_qty, pnl_24_h, position_qty, settle_price, seq, timestamp (position entry creation time), updated_time, unsettled_pnl, margin, and accrued_funding_fee; symbol and margin_mode are strings; leverage is an integer.

{"success":true,"data":{"current_margin_ratio_with_orders":1.2385,"free_collateral":450315.09115,"initial_margin_ratio":0.1,"initial_margin_ratio_with_orders":0.1,"maintenance_margin_ratio":0.05,"maintenance_margin_ratio_with_orders":0.05,"margin_ratio":1.2385,"open_margin_ratio":1.2102,"total_collateral_value":489865.71329,"total_pnl_24_h":0,"rows":[{"symbol":"PERP_BTC_USDC","position_qty":-5,"average_open_price":27908.14386047,"mark_price":27794.9,"settle_price":27865.8716984,"est_liq_price":117335.92899428,"unsettled_pnl":354.858492,"leverage":10,"margin_mode":"CROSS","margin":0,"accrued_funding_fee":0.005202}],"account_value":40.63345663},"timestamp":1702989203989}