Skip to main content

Documentation Index

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

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

Whale research bundle. Combines the address’s account state with its most recent trade fills. Useful when chasing addresses surfaced by topAddresses or platformPositions. Weight: 3

​
Request

{
  "type": "whaleContext",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "recent_trades_limit": 20
}
FieldTypeRequiredDefaultNotes
addressstringYes—Wallet address
broker_idstringNo—Optional
account_idstringNo—Optional
recent_trades_limitintNo20Clamped to [1, 50]

​
Response

FieldTypeNotes
accountobject | nullSubset of accountState; null on ADDRESS_NOT_FOUND
positions[]arrayOpen positions (same shape as accountState)
recent_trades[]arrayMost recent fills (same shape as trades); empty array on sub-handler failure

​
Notes

  • Sub-handlers run in parallel
  • Failures degrade gracefully — individual sections may be empty / null without failing the whole call
{
  "success": true,
  "data": {
    "account": { /* like agentContext.account */ },
    "positions": [ /* like accountState.positions[] */ ],
    "recent_trades": [ /* like trades.rows[] */ ]
  },
  "ts": 1779269143700
}