---
title: "Get hourly CEX/DEX buy-sell USD flow buckets for one coin"
method: GET
path: "/whales/flow/{coin}"
tags: ["whales"]
---

# Get hourly CEX/DEX buy-sell USD flow buckets for one coin

`GET /whales/flow/{coin}`

## Request

- Base URL: `https://coinlobster.com/api/ai/v1`
- URL: `https://coinlobster.com/api/ai/v1/whales/flow/{coin}`
- Auth: HTTP bearer

Returns hourly buy/sell USD buckets (CEX and DEX split) for one coin over a rolling 30-day window, verbatim.

## Path parameters

- `coin` string, required

## Query parameters

- `hours` integer

## Response `200`

Hourly flow rows, with meta.depth_note = '30-day rolling hourly window'

- 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.

---

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