Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orderly.network/docs/llms.txt

Use this file to discover all available pages before exploring further.

Recent liquidation events across the platform. Each row carries the liquidated address, account, and broker. Weight: 2

​
Request

{
  "type": "liquidations",
  "symbol": "PERP_ETH_USDC",
  "limit": 50
}
FieldTypeRequiredDefaultNotes
symbolstringNonullOmit → all symbols
limitintNo501..500
cursorstringNo—Opaque cursor

​
Response

FieldTypeNotes
sidestringLONG (liquidated long) or SHORT
position_qty, notionalstringDecimal
mark_price, est_liq_pricestringMark price at the moment of liquidation; named for symmetry with live est_liq_price
address, account_id, broker_idstring | nullnull if user lookup fails
timestampint64ms epoch

​
Notes

  • Account fields resolved via internal user lookup (60s cache)
{
  "success": true,
  "data": {
    "rows": [
      {
        "symbol": "PERP_ETH_USDC",
        "side": "LONG",
        "position_qty": "12.34",
        "notional": "567890.12",
        "mark_price": "4567.89",
        "est_liq_price": "4567.89",
        "address": "0x1234...",
        "account_id": "0xabc...",
        "broker_id": "orderly",
        "timestamp": 1716192000000
      }
    ],
    "next_cursor": null
  },
  "ts": 1779269143700
}