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 taker-side market trades for a symbol. Each trade carries the taker’s address, account, and broker — useful for whale detection and cross-referencing with accounts or accountState. Weight: 1

​
Request

{
  "type": "marketTrades",
  "symbol": "PERP_BTC_USDC",
  "limit": 50
}
FieldTypeRequiredDefaultNotes
symbolstringYes—Trading pair
limitintNo501..200 (silently clamped)

​
Response

FieldTypeNotes
sidestringTaker side — BUY or SELL
executed_price, executed_quantitystringDecimal
addressstringTaker’s wallet address (full, not truncated)
account_idstringTaker’s account
broker_idstringBroker the taker is on
executed_timestampint64ms epoch

​
Notes

  • Filters is_maker = false so every trade appears exactly once (taker only)
  • Per-row address lookup cached 60s
{
  "success": true,
  "data": {
    "rows": [
      {
        "symbol": "PERP_BTC_USDC",
        "side": "BUY",
        "executed_price": "77338.10",
        "executed_quantity": "0.0123",
        "address": "0x1234...",
        "account_id": "0xabc...",
        "broker_id": "orderly",
        "executed_timestamp": 1714900000000
      }
    ],
    "next_cursor": null
  },
  "ts": 1779269143700
}