Get One Position Info

#Get One Position Info

Returns position details for one symbol in the authenticated account.

#Endpoint

GET /v1/position/{symbol}

Mainnet: GET https://api.orderly.org/v1/position/{symbol}\\ Testnet: GET https://testnet-api.orderly.org/v1/position/{symbol}

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.

#Path parameter

• symbol (string, required): Trading symbol for the position.

#Query parameter

• margin_mode (enum string): CROSS or ISOLATED. Defaults to CROSS.

#Response

HTTP 200 returns success, required data, and server timestamp. Position data includes 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, and leverage is an integer.

{"success":true,"data":{"symbol":"PERP_BTC_USDC","position_qty":-5,"average_open_price":27908.14386047,"cost_position":-139329.358492,"mark_price":27794.9,"settle_price":27865.8716984,"est_liq_price":117335.92899428,"seq":1730181536341943600,"timestamp":1685429350571,"updated_time":1685429350571,"unsettled_pnl":354.858492,"leverage":10,"margin_mode":"CROSS","margin":0,"accrued_funding_fee":0.005202},"timestamp":1702989203989}