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.

Executed trade fills for an address. The handler transparently combines real-time fills (last 24 hours) with the archive (older than 24 hours); the cursor carries which source the next page is on, so pagination is continuous. Weight: 5

​
Request

{
  "type": "trades",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "symbol": "PERP_ETH_USDC",
  "start_time": 1714000000000,
  "end_time": 1715000000000,
  "limit": 200
}
FieldTypeRequiredDefaultNotes
addressstringYes—Wallet address
broker_idstringNo—Optional
account_idstringNo—Optional
symbolstringNo—Symbol filter
start_timeint64No—ms epoch
end_timeint64Nonow (when start_time set)ms epoch
limitintNo1001..1000 (without time range) or 1..2000 (with time range)
cursorstringNo—Opaque cursor (carries src)

​
Response

FieldTypeNotes
idstringTransaction ID
order_idstring | nullnull on orphaned / liquidation fills
is_makerbooltrue = maker, false = taker
realized_pnlstring | nullnull for fills older than 24 hours (archive does not retain this column)

​
Notes

  • 24-hour boundary: real-time data covers [max(start_time, now − 24h), end_time]; archived data covers [start_time, min(end_time, now − 24h − 1ms)]
  • Treat the cursor as opaque — always pass it back as-is
{
  "success": true,
  "data": {
    "rows": [
      {
        "id": "987654321",
        "order_id": "123456789",
        "symbol": "PERP_ETH_USDC",
        "side": "BUY",
        "executed_price": "2500.00",
        "executed_quantity": "0.5",
        "fee": "0.0005",
        "fee_asset": "USDC",
        "is_maker": false,
        "realized_pnl": "10.50",
        "executed_timestamp": 1714900000000
      }
    ],
    "next_cursor": "eyJsYXN0X2lkIjo5ODc2NTQzMjEsInNyYyI6Im15c3FsIn0"
  },
  "ts": 1779269143700
}