GET /v1/whales

Tracked whale wallets, portfolio holdings, interpretation signals, and aggregated AUM for the same managed snapshot as the dashboard Whales tab.

GET /api/v1/whales

Example

curl -s \
  -H "Authorization: Bearer kv_live_YOUR_KEY" \
  "https://app.kvantrank.com/api/v1/whales"

Field	Type	Description
`meta.product`	`string`	Product identifier (Kvantrank Data API).
`meta.tagline`	`string`	Short product summary.
`meta.docs`	`string`	URL to public API documentation.

Field	Type	Description
`whales[].address`	`string`	On-chain wallet address.
`whales[].name`	`string \| null`	Tracked wallet label.
`whales[].category`	`string \| null`	Wallet category (exchange, fund, etc.).
`whales[].portfolio_value`	`number \| null`	Estimated portfolio value (USD).
`whales[].holdings[]`	`array`	Token holdings with symbol, value, and allocation.

Field	Type	Description
`whale_signals[].address`	`string`	Wallet address for the signal.
`whale_signals[].date_utc`	`string`	UTC date of the signal window.
`whale_signals[].pattern`	`string \| null`	Detected flow pattern.
`whale_signals[].directional_bias`	`string \| null`	Accumulation vs distribution bias.
`whale_signals[].confidence`	`number \| null`	Interpretation confidence.
`whale_signals[].score`	`number \| null`	Normalized signal score.

Field	Type	Description
`total_aum`	`number \| null`	Sum of tracked whale portfolio values (USD).
`total_aum_share`	`number \| null`	Share of tracked universe AUM.
`top_held_asset`	`string \| null`	Most-held asset symbol across whales.
`top_held_asset_val`	`number \| null`	USD value of the top held asset.

Field	Type	Description
`aggregated_holdings[].symbol`	`string`	Token symbol.
`aggregated_holdings[].name`	`string`	Token name.
`aggregated_holdings[].coingecko_id`	`string \| null`	CoinGecko id when mapped.
`aggregated_holdings[].value_usd`	`number \| null`	Aggregate USD value held.
`aggregated_holdings[].whales[]`	`array`	Whale addresses contributing to this holding.

Snapshot fields (price, cap, volume) align to the same UTC pipeline run as Kvantrank scores. Intraday charting may need a separate live feed.