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

# Get Exchange Flows

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

## Request

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

Net Transfer flow to/from CEX wallets for `symbol`, across windows.

Symbol must be a token tracked by the exchange-flows collector across the
supported chains (ETH, BSC, Base, Arbitrum, Optimism, Tron, Solana), or native
BTC (balance deltas on Binance, Bybit and OKX wallets from their own
proof-of-reserves lists). The same symbol
can be tracked on multiple chains; see `by_chain`.

`exchanges_covered` lists the exchanges with at least one watched wallet on a
chain carrying the symbol. Any other exchange is `null` in `per_exchange_24h`
(unknown, not zero: Coinbase and Kraken publish no BTC addresses), and an
`exchange` filter naming one makes every window `null`.

The 1h/6h/24h/7d windows show inflow, outflow, and net. Positive net = more
deposits to CEXs (often bearish — incoming sell-side liquidity). Negative
net = withdrawals from CEXs (often bullish).

`by_chain` breaks the same windows down per chain (only chains with data for
this symbol are present) and `chains_covered` lists them — matching the
daily-archive shape so live and backfilled snapshots line up.

`spike_zscore_1h` flags the latest 1h vs the prior hour's baseline; values
> 2 indicate a statistically unusual spike.

## Path parameters

- `symbol` string, required

## Query parameters

- `exchange` string, nullable: Filter to one exchange (e.g. 'binance')

## Response `200`

Successful Response

- ExchangeFlowsResponse
  - `symbol` string, required
  - `exchange_filter` string, nullable
  - `as_of` integer, required
  - `windows` object, required
  - `per_exchange_24h` object, required
  - `exchanges_covered` string[]
  - `by_chain` object
  - `chains_covered` string[]
  - `spike_zscore_1h` number, nullable
  - `spike_zscore_24h` number, nullable

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