> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CeFi Balances

> Daily token balance, in native units and USD, held by one centralized venue (an exchange, custodian, fund, miner or government) for one token on one chain. Each series is one venue token balance, keyed by chain, token address, venue and venue type. Many series per venue, so name the balances you need.

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 20 per call) |

## Endpoints

> **[List CeFi Balances](https://docs.blockworks.com/api-reference/data-api/centralized-finance/tabular-cefi-balances.md)**
>
> One page of rows with per-column filters, sorting and pagination.

> **[Batch Get CeFi Balance timeseries](https://docs.blockworks.com/api-reference/data-api/centralized-finance/timeseries-cefi-balances.md)**
>
> Up to 20 series in one request, named by CeFi Balance ID in `series`.

> **[Get CeFi Balance timeseries](https://docs.blockworks.com/api-reference/data-api/centralized-finance/timeseries-cefi-balances-by-id.md)**
>
> One series over a time window, keyed by its CeFi Balance ID.

## Metrics

2 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

```bash curl theme={null}
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 Balance timeseries](https://docs.blockworks.com/api-reference/data-api/centralized-finance/timeseries-cefi-balances-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.