Skip to main content
GET
/
v1
/
position_history
Get position history
curl --request GET \
  --url https://api.orderly.org/v1/position_history \
  --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": {
    "rows": [
      {
        "position_id": 1,
        "status": "closed",
        "type": "liquidated",
        "symbol": "PERP_ETH_USDC",
        "avg_open_price": 61016.1,
        "avg_close_price": 61016.1,
        "max_position_qty": 56.6,
        "closed_position_qty": 56.6,
        "side": "LONG",
        "trading_fee": 0.015,
        "accumulated_funding_fee": 0.11,
        "insurance_fund_fee": 0,
        "liquidator_fee": 0,
        "liquidation_id": null,
        "realized_pnl": -9.09691927314905,
        "open_timestamp": 1685429350571,
        "close_timestamp": 1685429350571,
        "last_update_timestamp": 1685429350571,
        "leverage": 10,
        "margin_mode": "CROSS"
      }
    ]
  },
  "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.

Query Parameters

​
symbol
string
​
limit
number
required

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