Skip to main content
GET
/
v1
/
positions
Get all positions info
curl --request GET \
  --url https://api.orderly.org/v1/positions \
  --header 'orderly-account-id: <orderly-account-id>' \
  --header 'orderly-key: <orderly-key>' \
  --header 'orderly-signature: <orderly-signature>' \
  --header 'orderly-timestamp: <orderly-timestamp>'
{
  "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": [
      {
        "IMR_withdraw_orders": 0.1,
        "MMR_with_orders": 0.05,
        "average_open_price": 27908.14386047,
        "cost_position": -139329.358492,
        "est_liq_price": 117335.92899428,
        "fee_24_h": 0,
        "imr": 0.1,
        "last_sum_unitary_funding": 70.38,
        "mark_price": 27794.9,
        "mmr": 0.05,
        "pending_long_qty": 0,
        "pending_short_qty": 0,
        "pnl_24_h": 0,
        "position_qty": -5,
        "settle_price": 27865.8716984,
        "symbol": "PERP_BTC_USDC",
        "seq": 1730181536341943600,
        "timestamp": 1685429350571,
        "updated_time": 1685429350571,
        "unsettled_pnl": 354.858492,
        "leverage": 10,
        "margin_mode": "CROSS",
        "margin": 0,
        "accrued_funding_fee": 0.005202
      }
    ],
    "account_value": 40.63345663
  },
  "timestamp": 1702989203989
}

Headers

orderly-timestamp
string
required

Timestamp of the signed request in milliseconds.

orderly-account-id
string
required

Account ID of the authenticated account.

orderly-key
string
required

Public orderly key used to sign the request.

orderly-signature
string
required

Signature of the request payload generated with the orderly key.

Response

200 - application/json

OK

success
boolean
required

Indicates whether the request was successful.

Example:

true

data
object
required
timestamp
integer

Server timestamp in milliseconds.

Example:

1702989203989