Skip to main content
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
}