---
title: "Get daily whale buy/sell flow history for a coin"
method: GET
path: "/history/whale-flow-daily"
tags: ["whales"]
---

# Get daily whale buy/sell flow history for a coin

`GET /history/whale-flow-daily`

## Request

- Base URL: `https://coinlobster.com/api/ai/v1`
- URL: `https://coinlobster.com/api/ai/v1/history/whale-flow-daily`
- Auth: HTTP bearer

Daily whale flow per coin with the CEX/DEX split, compacted from the recorded gold archive (since 2026-06-18): buy USD, sell USD, CEX vs DEX share, trade count per UTC day. Absent days had no recorded whale flow. Costs 30 credits.

## Query parameters

- `coin` string
- `days` integer

## Response `200`

Daily series: { coin, days: [{d, buyUsd, sellUsd, cexUsd, dexUsd, count}], coverage_note }

- 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`: No archived whale-flow history for this coin

---

[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)