Whale context

Whale research bundle: account state, open positions, and recent trades for an address in one call.

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
}

Field	Type	Required	Default	Notes
address	string	Yes	—	Wallet address
broker_id	string	No	—	Optional
account_id	string	No	—	Optional
recent_trades_limit	int	No	20	Clamped to [1, 50]

Response

Field	Type	Notes
account	object | null	Subset of accountState; null on ADDRESS_NOT_FOUND
positions[]	array	Open positions (same shape as accountState)
recent_trades[]	array	Most 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

Response

{
  "success": true,
  "data": {
    "account": { /* like agentContext.account */ },
    "positions": [ /* like accountState.positions[] */ ],
    "recent_trades": [ /* like trades.rows[] */ ]
  },
  "ts": 1779269143700
}