---
title: "Get Exchange Flow History"
method: GET
path: "/api/v1/on-chain/exchange-flows/{symbol}/history"
tags: ["On-Chain Intelligence"]
---

# Get Exchange Flow History

`GET /api/v1/on-chain/exchange-flows/{symbol}/history`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/on-chain/exchange-flows/{symbol}/history`
- Auth: API key in header `X-API-Key`

Archived CEX inflow/outflow for `symbol`, back to 2026-05-28.

The rolling windows on `/exchange-flows/{symbol}` have been sampled every
~30 minutes since 2026-05-28. Each point is one sample: the trailing 1h and
24h inflow/outflow/net summed across chains (and exchanges, unless
`exchange` is given), plus the 1h window per exchange. `interval=1h` keeps
the last sample in each UTC hour; `raw` returns every sample (their 1h
windows overlap). At most 93 days per request.

Amounts are in the token's own units (USD only for USDT/USDC/DAI) — the same
units as the live endpoint.

## Path parameters

- `symbol` string, required

## Query parameters

- `start` string, nullable: ISO 8601, unix seconds or unix ms. Default: 7 days before `end`
- `end` string, nullable: ISO 8601, unix seconds or unix ms (EXCLUSIVE). Default: now
- `interval` string: 1h (last sample per UTC hour) | raw (every sample)
- `exchange` string, nullable: Only this exchange (e.g. binance)
- `chain` string, nullable: Only this chain (e.g. eth, tron)

## Response `200`

Successful Response

- ExchangeFlowHistoryResponse
  - `symbol` string, required
  - `unit` string, required: Unit of every amount — the token itself; USD only for USDT/USDC/DAI
  - `exchange_filter` string, nullable
  - `chain_filter` string, nullable
  - `interval` string, required: 1h (last sample per UTC hour) | raw (every ~30-min sample)
  - `start` integer, required
  - `end` integer, required
  - `count` integer, required
  - `points` FlowHistoryPoint[], required
    - `ts` integer, required: Unix seconds the sample was taken; the 1h/24h windows are trailing from here
    - `inflow_1h` number, required
    - `outflow_1h` number, required
    - `net_1h` number, required: inflow - outflow (positive = net deposits to exchanges)
    - `inflow_24h` number, required
    - `outflow_24h` number, required
    - `net_24h` number, required
    - `chains` string[], required: Chains contributing to this sample
    - `per_exchange_1h` object, required: The trailing-1h window per exchange

## Other responses

- `422`: Validation Error

---

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