---
title: "Get vs-own-history whale-flow context"
method: GET
path: "/whales/context"
tags: ["whales"]
---

# Get vs-own-history whale-flow context

`GET /whales/context`

## Request

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

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.

## Query parameters

- `coin` string

## Response `200`

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.

- object
  - `success` true, required
  - `data` object, required: Endpoint-specific payload. Every field it carries is documented in llms-full.txt and returned by /discover.
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

## Other responses

- `404`: Coin below the coverage or volume gates (not yet enough logged history). A coin excluded by design instead returns 200 with stats: null -- see the 200 response above.

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)