whales

Get vs-own-history whale-flow context

Per-coin derived stats: rolling 24h flow as a multiple of the coin's own logged daily average, N-day high, buy share now vs 7d/30d, net 24h flow, plus market breadth (how many covered coins run hot). Windows are each coin's real logged days. Omit coin for the full covered map. Costs 20 credits.

get/whales/context

Request

  • Base URL: https://coinlobster.com/api/ai/v1
  • URL: https://coinlobster.com/api/ai/v1/whales/context
  • Auth: HTTP bearer

Query parameters

coinstring

Coin symbol, e.g. BTC; omit for all covered coins

Response

Context stats: { as_of_ms, since_day, valid_days, breadth, coin?, stats?|coins? }. For a single coin that is permanently excluded by design (stablecoin or wrapped/staked asset, e.g. USDT or WBTC), this is still a 200: stats is null and the payload instead carries excluded: true, reason: "stablecoin_or_wrapped", and a human-readable message explaining why that coin never gets context. A coin merely below the coverage/volume gates (context not built up yet) is a 404 instead, not this shape.

successtrue required
dataobject required

Endpoint-specific payload. Every field it carries is documented in llms-full.txt and returned by /discover.

Changes

No recorded changes to this operation across all 1 revision of this API.