Whale context

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

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

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

Deposits and withdrawals Platform positions

⌘I

Builder quickstart

Partner onboarding & support

Core integration flows

Builders Marketplace

API fundamentals

Public Info API

General API

User API

Trading API

Strategy vault API

Staking & VALOR API

Builder API

Points module

Market data API

Websocket API

Request

Response

Notes

​Request

​Response

​Notes

Request

Response

Notes