CeFi Balances and Flows

One row per token held by a centralized venue on one chain, keyed by chain, token address, venue and venue type: the venue (an exchange, custodian, fund, miner or government), its type, the token and the chain. The id is the series key of the cefi-balances timeseries model.


Access	Exchanges-dataset
Tabular model	`cefi-balances`: primary key `id`
Timeseries model	`cefi-balances`: intervals `1d`, series key `id` (CeFi Balance ID), series must be named (up to 10 per call)

Endpoints

List CeFi Balances and Flows

One page of rows with per-column filters, sorting and pagination.

Batch Get CeFi Balances and Flows timeseries

Up to 10 series in one request, named by CeFi Balance ID in series.

Get CeFi Balances and Flows timeseries

One series over a time window, keyed by its CeFi Balance ID.

Metrics

8 metrics. Use the Field value in selections; every point starts with the timestamp and continues in this order.

Field	Name	Type	Unit	Description
`balance`	Balance	float64		Token balance held by the venue, in native units.
`balanceUSD`	Balance (USD)	float64		Token balance held by the venue in USD.

Columns

Use the Field value in selections, sortBy, and as the base of a filter parameter (Field plus one of its Filters suffixes).

Field	Type	Filters	Sort	Description
`id`	string	`Eq`, `IsOneOf`		The series key of the cefi-balances timeseries model, the chain, token address, venue id and venue type, joined with underscores. (primary key)
`name`	string	`Eq`, `IsOneOf`, `Contains`	default	The display name of the balance, the venue and token.
`chain`	string	`Eq`, `IsOneOf`	yes	The short name of the chain (ethereum, base, solana).
`tokenAddress`	string	`Eq`, `IsOneOf`		The token contract address (the mint address on Solana).
`cefiID`	string	`Eq`, `IsOneOf`	yes	The centralized venue’s identifier (binance, coinbase-prime, us-government).
`cefiType`	string	`Eq`, `IsOneOf`		The centralized venue’s type (cex, custody, fund, miner, government).
`networkID`	string	`Eq`, `IsOneOf`		The chain’s networkID in the blockchains model; null when unmapped.
`networkSlug`	string	`Eq`, `IsOneOf`		The chain’s slug in the blockchains model; null when unmapped.

Example

curl

curl "https://api.blockworks.com/query/timeseries/cefi-balances/1d/<id>?timeframe=7d&selections=balance,balanceUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get CeFi Balances and Flows timeseries for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts