# Aggregated Exchange Data API Developer Documentation

## 1. Overview

- Base URL: `http://0xrouter.app`
- Method: `GET`
- Authentication header: `X-My-Token`
- Response format: `JSON`
- Platform identifier: `cexdata`

Every request must include:

```http
X-My-Token: <your_token>
```

Notes:

- Aggregated exchange data endpoints are organized from web data sources, so paths, parameters, and response structures differ from upstream public Open APIs. Use this document as the source of truth.
- Multi-value parameters are passed as comma-separated strings, for example `cexname_list=Binance,Bybit,OKX`. Single-exchange `cexname` parameters do not support comma-separated values, and the gateway returns `400` before forwarding upstream.
- The gateway always requires `X-My-Token`, even if some upstream endpoints support anonymous access.
- Web data sources may change with upstream pages. Callers should read fields defensively.
- Historical K-line endpoints can fetch up to `300` K-lines per request. The orderbook history heatmap endpoints cap at `20` K-lines per request, and large limit-order history caps at `50`. Out-of-range requests return `400` before forwarding upstream.
- About the `pair` and `coin` parameters: this document explicitly distinguishes "coin vs trading pair" by using two parameter names — `pair` for trading pairs like `BTCUSDT` and `coin` for coin symbols like `BTC`. Endpoints that take a single `cexname` use `pair`; endpoints that aggregate across exchanges or do not target a specific exchange use `coin`. **The legacy `symbol` parameter is permanently supported as an alias** — calling `?symbol=...` keeps working with identical semantics even after the doc switched to `pair`/`coin`.

## 2. Authorization, Billing, and Rate Limits

### 2.1 Authorization

CexData is currently authorized by validity period plus per-project rate limit:

- Enabled accounts can call authorized endpoints before the project expires.
- Each token has its own project-level rate limit.
- Expired, disabled, or unauthorized projects return permission errors.
- CexData custom endpoints cache successful responses for `20` seconds keyed by endpoint path and query parameters to reduce repeated upstream traffic.

### 2.2 Billing

- The current authorization is validity-based and is not charged per response size.
- Auth failures, unauthorized projects, expired projects, upstream failures, and final gateway failures are not counted as valid calls.
- If the billing model later changes to points or hybrid, follow the console display and admin configuration.

### 2.3 Rate Limits

- The default rate limit follows the per-token `rate_limit_per_minute` configured by the admin.
- CexData endpoints are generally more suitable for high-frequency polling than on-chain intelligence endpoints, but local caching is still recommended for hot endpoints.
- For high-frequency endpoints such as funding rate, open interest, liquidation, and long-short ratio, choose a polling interval that fits your business needs.

## 3. Supported Endpoint Groups

| Group | Path prefix | Description |
| :--- | :--- | :--- |
| Calendar | `/cexdata/calendar/*` | Economic calendar, financial events, central bank activities |
| Coin | `/cexdata/coin/*` | Coin unlock list and unlock detail |
| ETF | `/cexdata/etf/*` | BTC / ETH / SOL / XRP ETF list, net assets history, flow history |
| Exchange | `/cexdata/exchange/*` | Exchange asset summaries and on-chain coin balance lists |
| Futures | `/cexdata/futures/*` | Futures markets, K-lines, funding rate, long-short ratio, liquidation, orderbook, taker buy/sell |
| Option | `/cexdata/option/*` | Option max pain, exchange open interest history |
| Spot | `/cexdata/spot/*` | Spot markets, K-lines, orderbook, taker buy/sell, netflow |

## 4. Endpoint Directory (Alphabetical)

The directory below is grouped alphabetically by path prefix. The account endpoints in section 5 are gateway management endpoints and are listed separately.

#### Calendar

- `GET /cexdata/calendar/central-bank-activities`
- `GET /cexdata/calendar/economic-data`
- `GET /cexdata/calendar/financial-events`

#### Coin

- `GET /cexdata/coin/unlock-list`
- `GET /cexdata/coin/vesting`

#### ETF

- `GET /cexdata/etf/bitcoin/detail`
- `GET /cexdata/etf/bitcoin/flow-history`
- `GET /cexdata/etf/bitcoin/list`
- `GET /cexdata/etf/bitcoin/net-assets/history`
- `GET /cexdata/etf/ethereum/flow-history`
- `GET /cexdata/etf/ethereum/list`
- `GET /cexdata/etf/solana/flow-history`
- `GET /cexdata/etf/solana/list`
- `GET /cexdata/etf/xrp/flow-history`
- `GET /cexdata/etf/xrp/list`

#### Exchange

- `GET /cexdata/exchange/assets`
- `GET /cexdata/exchange/balance/list`

#### Futures

- `GET /cexdata/futures/aggregated-cvd/history`
- `GET /cexdata/futures/aggregated-taker-buy-sell-volume/history`
- `GET /cexdata/futures/cex`
- `GET /cexdata/futures/cexdexlist`
- `GET /cexdata/futures/coin/netflow`
- `GET /cexdata/futures/coins-markets`
- `GET /cexdata/futures/cvd/history`
- `GET /cexdata/futures/funding-rate/arbitrage`
- `GET /cexdata/futures/funding-rate/global-long-short-account-ratio/history`
- `GET /cexdata/futures/funding-rate/history`
- `GET /cexdata/futures/funding-rate/interestArbitrage`
- `GET /cexdata/futures/funding-rate/oi-weight-history`
- `GET /cexdata/futures/funding-rate/top-long-short-account-ratio/history`
- `GET /cexdata/futures/funding-rate/top-long-short-position-ratio/history`
- `GET /cexdata/futures/hyperliquid/liqMap`
- `GET /cexdata/futures/hyperliquid/position`
- `GET /cexdata/futures/hyperliquid/whale-alert`
- `GET /cexdata/futures/hyperliquid/whale-position`
- `GET /cexdata/futures/liquidation/aggregated-heatmap/model`
- `GET /cexdata/futures/liquidation/aggregated-history`
- `GET /cexdata/futures/liquidation/aggregated-map`
- `GET /cexdata/futures/liquidation/coin-list`
- `GET /cexdata/futures/liquidation/exchange-list`
- `GET /cexdata/futures/liquidation/heatmap/model`
- `GET /cexdata/futures/liquidation/history`
- `GET /cexdata/futures/liquidation/map`
- `GET /cexdata/futures/liquidation/max-pain`
- `GET /cexdata/futures/liquidation/order`
- `GET /cexdata/futures/net-position/history`
- `GET /cexdata/futures/netflow-list`
- `GET /cexdata/futures/open-interest/aggregated-coin-margin-history`
- `GET /cexdata/futures/open-interest/aggregated-history`
- `GET /cexdata/futures/open-interest/history`
- `GET /cexdata/futures/orderbook/aggregated-ask-bids-history`
- `GET /cexdata/futures/orderbook/ask-bids-history`
- `GET /cexdata/futures/orderbook/history`
- `GET /cexdata/futures/orderbook/large-limit-order-history`
- `GET /cexdata/futures/pairs-coins`
- `GET /cexdata/futures/pairs-markets`
- `GET /cexdata/futures/price/history`
- `GET /cexdata/futures/taker-buy-sell-volume/exchange-list`
- `GET /cexdata/futures/v2/net-position/history`
- `GET /cexdata/futures/v2/taker-buy-sell-volume/history`
- `GET /cexdata/futures/volume/footprint-history`

#### Option

- `GET /cexdata/option/exchange-oi-history`
- `GET /cexdata/option/max-pain`

#### Spot

- `GET /cexdata/spot/aggregated-cvd/history`
- `GET /cexdata/spot/aggregated-taker-buy-sell-volume/history`
- `GET /cexdata/spot/coin/netflow`
- `GET /cexdata/spot/coins-markets`
- `GET /cexdata/spot/cvd/history`
- `GET /cexdata/spot/netflow-list`
- `GET /cexdata/spot/orderbook/aggregated-ask-bids-history`
- `GET /cexdata/spot/orderbook/ask-bids-history`
- `GET /cexdata/spot/orderbook/history`
- `GET /cexdata/spot/orderbook/large-limit-order-history`
- `GET /cexdata/spot/pairs-coins`
- `GET /cexdata/spot/pairs-markets`
- `GET /cexdata/spot/price/history`
- `GET /cexdata/spot/taker-buy-sell-volume/history`
- `GET /cexdata/spot/volume/footprint-history`

## 5. Account Endpoints

### 5.1 `GET /account/balance`

Returns the current token's balances, project permissions, blocked status, expiration time, and rate limit configuration across all platforms.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/account/balance" \
  -H "X-My-Token: your_token"
```

### 5.2 `GET /account/balance/{platform}`

Returns balance, project permission, blocked status, expiration time, and rate limit configuration for the specified platform.

### Path Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `platform` | `string` | **[required]** Platform identifier. The aggregated exchange data platform is `cexdata` |

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/account/balance/cexdata" \
  -H "X-My-Token: your_token"
```

### 5.3 `GET /account/usage`

Returns the current token's call logs, deducted points, response size, elapsed time, and pagination information.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `platform` | `string` | **[optional]** Filter by platform, for example `cexdata` |
| `start` | `string` | **[optional]** Start time, Unix timestamp or date |
| `end` | `string` | **[optional]** End time, Unix timestamp or date |
| `page` | `integer` | **[optional]** Page number, starts from `1` |
| `limit` | `integer` | **[optional]** Rows to return. Non-admin maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/account/usage" \
  -H "X-My-Token: your_token" \
  --data-urlencode "platform=cexdata" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=100"
```

## 6. Futures Data

### 6.1 `GET /cexdata/futures/hyperliquid/whale-alert`

Returns Hyperliquid whale action alert data.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/futures/hyperliquid/whale-alert" \
  -H "X-My-Token: your_token"
```

### 6.2 `GET /cexdata/futures/hyperliquid/whale-position`

Returns Hyperliquid whale position data.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/futures/hyperliquid/whale-position" \
  -H "X-My-Token: your_token"
```

### 6.3 `GET /cexdata/futures/hyperliquid/position`

Returns Hyperliquid whale position data filtered by coin symbol.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/hyperliquid/position" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 6.4 `GET /cexdata/futures/hyperliquid/liqMap`

Returns Hyperliquid liquidation map data for a selected coin symbol. The gateway removes `id`, `isFavorite`, and `price` fields from list rows and renames `userId` to `hypeaddress`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/hyperliquid/liqMap" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 6.5 `GET /cexdata/futures/cexdexlist`

Returns the currently supported futures CEX/DEX exchange list along with related global futures market data.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/futures/cexdexlist" \
  -H "X-My-Token: your_token"
```

### 6.6 `GET /cexdata/futures/cex`

Returns the futures trading pairs of the selected exchange queried by exchange name.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance`; do not pass comma-separated exchange names |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/cex" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance"
```

### 6.7 `GET /cexdata/futures/pairs-coins`

Returns futures exchange trading-pair enumeration data searched by coin symbol.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/pairs-coins" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 6.8 `GET /cexdata/futures/coins-markets`

Returns futures market data for one or more selected exchanges, including price, volume, open interest, long-short ratio, and market structure fields. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/coins-markets" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 6.9 `GET /cexdata/futures/pairs-markets`

Returns futures market data of a base coin's trading pairs across exchanges, including price, volume, open interest, and change fields.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Trading pair base symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/pairs-markets" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 6.10 `GET /cexdata/futures/price/history`

Returns historical futures pair candlestick data, including time, open, high, low, close, and volume in USD. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `m5`/`5m`, `m15`/`15m`, `m30`/`30m`, `h1`/`1h`, `h4`/`4h`, or `d1`/`1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/price/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.11 `GET /cexdata/futures/open-interest/history`

Returns historical futures open interest candlestick data, including time, open, high, low, and close open interest values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/open-interest/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.12 `GET /cexdata/futures/open-interest/aggregated-history`

Returns aggregated historical USDT-margin futures open interest candlestick data across one or more exchanges, including time, open, high, low, and close values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol or trading pair, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/open-interest/aggregated-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.13 `GET /cexdata/futures/open-interest/aggregated-coin-margin-history`

Returns aggregated historical coin-margin futures open interest candlestick data across one or more exchanges, including time, open, high, low, and close values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/open-interest/aggregated-coin-margin-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.14 `GET /cexdata/futures/funding-rate/history`

Returns historical futures funding rate candlestick data, including time, open, high, low, and close funding rate values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.15 `GET /cexdata/futures/funding-rate/oi-weight-history`

Returns historical open-interest-weighted futures funding rate candlestick data, including time, open, high, low, and close funding rate values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/oi-weight-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.16 `GET /cexdata/futures/funding-rate/arbitrage`

Returns futures funding rate arbitrage list data. The optional `cexname` parameter defaults to `all` (all exchanges).

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[optional]** Exchange name. Defaults to `all` (all exchanges) |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/arbitrage" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=all"
```

### 6.17 `GET /cexdata/futures/funding-rate/interestArbitrage`

Returns futures funding rate interest arbitrage data.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/futures/funding-rate/interestArbitrage" \
  -H "X-My-Token: your_token"
```

### 6.18 `GET /cexdata/futures/funding-rate/global-long-short-account-ratio/history`

Returns historical futures global long-short account ratio candlestick data, including time, open, high, low, and close ratio values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/global-long-short-account-ratio/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.19 `GET /cexdata/futures/funding-rate/top-long-short-account-ratio/history`

Returns historical futures top-trader long-short account ratio candlestick data, including time, open, high, low, and close ratio values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/top-long-short-account-ratio/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.20 `GET /cexdata/futures/funding-rate/top-long-short-position-ratio/history`

Returns historical futures top-trader long-short position ratio candlestick data, including time, open, high, low, and close ratio values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/funding-rate/top-long-short-position-ratio/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.21 `GET /cexdata/futures/taker-buy-sell-volume/exchange-list`

Returns historical futures coin taker buy/sell ratio K-line data for a selected exchange and trading pair, including time and ratio values. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/taker-buy-sell-volume/exchange-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.22 `GET /cexdata/futures/net-position/history`

Returns historical net long/short position K-line data for a futures trading pair. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/net-position/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.23 `GET /cexdata/futures/v2/net-position/history`

Returns historical net long/short position v2 K-line data for a futures trading pair. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/v2/net-position/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.24 `GET /cexdata/futures/liquidation/history`

Returns historical futures trading-pair liquidation data, including time, short liquidation amount in USDT, and long liquidation amount in USDT. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.25 `GET /cexdata/futures/liquidation/aggregated-history`

Returns historical futures coin aggregated liquidation data for a selected exchange and trading pair, including time, short liquidation amount in USDT, and long liquidation amount in USDT. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/aggregated-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.26 `GET /cexdata/futures/liquidation/coin-list`

Returns a futures exchange coin liquidation ranking list for one or more selected exchanges, including symbol and total liquidation, long liquidation, and short liquidation amounts in USDT across the `interval` window, sorted descending. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `interval` | `string` | **[required]** Data interval, for example `1h`, `4h`, `12h`, or `24h` |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/coin-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "interval=1h" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 6.27 `GET /cexdata/futures/liquidation/exchange-list`

Returns futures coin liquidation time-series data. Each time point includes price and a list of `All` plus per-exchange total, long, and short liquidation amounts in USD.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |
| `interval` | `string` | **[optional]** Data interval. Only `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `12h`, or `all` is supported. Default: `all` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/exchange-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=all"
```

### 6.28 `GET /cexdata/futures/liquidation/max-pain`

Returns futures liquidation max pain data, including price, long risk, short risk, and max long/short liquidation amounts with their corresponding prices.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `range` | `string` | **[required]** Time range. Only `12h`, `24h`, `48h`, `3d`, `7d`, `14d`, or `30d` is supported |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/max-pain" \
  -H "X-My-Token: your_token" \
  --data-urlencode "range=24h"
```

### 6.29 `GET /cexdata/futures/liquidation/order`

Returns recent futures liquidation orders. The response is flattened to `data.list`; the `exchangeLogo` and `symbolLogo` fields are removed; `exchangeName` is renamed to `cexname`. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `volUsd` | `string` | **[required]** Minimum USD volume threshold, for example `10000` |
| `coin` | `string` | **[optional]** Coin symbol; leave blank to query all, for example `BTC` |
| `cexname` | `string` | **[optional]** Exchange name; leave blank to query all, for example `Binance` |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/order" \
  -H "X-My-Token: your_token" \
  --data-urlencode "volUsd=10000" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 6.30 `GET /cexdata/futures/liquidation/heatmap/model`

Returns pair liquidation heatmap data. `range` is mapped to the data interval and row count automatically.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `pair` | `string` | **[required]** Complete trading pair, for example `BTCUSDT` or `ETHUSDT` |
| `cexname` | `string` | **[required]** Exchange name, for example `Binance` or `OKX` |
| `range` | `string` | **[required]** Time range. Only `12h`, `1d`, `2d`, or `3d` is supported; case-insensitive |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/heatmap/model" \
  -H "X-My-Token: your_token" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "range=1d"
```

### 6.31 `GET /cexdata/futures/liquidation/aggregated-heatmap/model`

Returns aggregated coin liquidation heatmap data. `range` is mapped to the data interval and row count automatically.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |
| `range` | `string` | **[required]** Time range. Only `12h`, `1d`, `2d`, or `3d` is supported; case-insensitive |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/aggregated-heatmap/model" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "range=1d"
```

### 6.32 `GET /cexdata/futures/liquidation/map`

Returns pair liquidation map data for a selected exchange and complete trading pair. `range` is mapped to the data interval and row count automatically.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `exchange` | `string` | **[required]** Exchange name, for example `Binance` or `OKX` |
| `pair` | `string` | **[required]** Complete trading pair, for example `ETHUSDT` or `BTCUSDT` |
| `range` | `string` | **[required]** Time range. Only `1d`, `7d`, or `30d` is supported; case-insensitive |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/map" \
  -H "X-My-Token: your_token" \
  --data-urlencode "exchange=Binance" \
  --data-urlencode "pair=ETHUSDT" \
  --data-urlencode "range=1d"
```

### 6.33 `GET /cexdata/futures/liquidation/aggregated-map`

Returns aggregated coin liquidation map data. `range` is mapped to the data interval and row count automatically.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |
| `range` | `string` | **[required]** Time range. Only `1d`, `7d`, or `30d` is supported; case-insensitive |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/liquidation/aggregated-map" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "range=1d"
```

### 6.34 `GET /cexdata/futures/orderbook/ask-bids-history`

Returns historical futures trading-pair orderbook ask/bid depth data for a selected exchange and trading pair, including time, bid quantity, ask quantity, bid USD amount, and ask USD amount. `startTime` and `endTime` can cover at most `300` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `depth` | `string` | **[required]** Orderbook depth difference. Only `1`, `0.75`, `0.5`, or `0.25` is supported, corresponding to `1%`, `0.75%`, `0.5%`, and `0.25%` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `12h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `300` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/orderbook/ask-bids-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "depth=1" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.35 `GET /cexdata/futures/orderbook/aggregated-ask-bids-history`

Returns historical futures aggregated coin orderbook ask/bid depth data for a selected exchange list, including time, bid quantity, ask quantity, bid USD amount, and ask USD amount. `startTime` and `endTime` can cover at most `300` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX,Deribit` |
| `coin` | `string` | **[required]** Coin symbol, for example `ZEC`, `BTC`, or `ETH` |
| `depth` | `string` | **[required]** Orderbook depth difference. Only `1`, `0.75`, `0.5`, or `0.25` is supported, corresponding to `1%`, `0.75%`, `0.5%`, and `0.25%` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `12h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `300` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/orderbook/aggregated-ask-bids-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX,Deribit" \
  --data-urlencode "coin=ZEC" \
  --data-urlencode "depth=1" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.36 `GET /cexdata/futures/orderbook/history`

Returns orderbook history heatmap data. `startTime` and `endTime` can cover at most `20` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `exchange` | `string` | **[required]** Exchange name, for example `Binance` or `OKX` |
| `pair` | `string` | **[required]** Complete trading pair, for example `BTCUSDT` or `ETHUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `3m`, `5m`, `15m`, `30m`, `h1`, `h4`, or `d1` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `20` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/orderbook/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "exchange=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.37 `GET /cexdata/futures/orderbook/large-limit-order-history`

Returns historical futures large limit-order data for a selected exchange and trading pair. Each request can fetch up to `50` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/orderbook/large-limit-order-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.38 `GET /cexdata/futures/v2/taker-buy-sell-volume/history`

Returns historical futures pair taker buy and sell volume in USD. `interval` uses the same K-line format as other futures history endpoints, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/v2/taker-buy-sell-volume/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.39 `GET /cexdata/futures/aggregated-taker-buy-sell-volume/history`

Returns historical taker buy/sell quantity for a coin aggregated across one or more exchanges. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/aggregated-taker-buy-sell-volume/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.40 `GET /cexdata/futures/volume/footprint-history`

Returns historical futures footprint chart data for a selected exchange and trading pair, returned as a 2D array structure. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/volume/footprint-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.41 `GET /cexdata/futures/cvd/history`

Returns historical futures volume delta data for a selected exchange and trading pair, including time, taker buy volume, taker sell volume, and per-K-line buy minus sell volume delta. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/cvd/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.42 `GET /cexdata/futures/aggregated-cvd/history`

Returns historical aggregated futures CVD data across one or more exchanges, including time, taker buy volume, taker sell volume, and per-K-line buy minus sell volume delta. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/aggregated-cvd/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 6.43 `GET /cexdata/futures/netflow-list`

Returns a futures coin-aggregated inflow/outflow list, sorted by market cap descending. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/netflow-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 6.44 `GET /cexdata/futures/coin/netflow`

Returns futures coin-aggregated inflow/outflow data for a single coin, expanded into per-time-window arrays.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/futures/coin/netflow" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

## 7. Spot Data

### 7.1 `GET /cexdata/spot/coins-markets`

Returns the spot coin market list sorted by market cap descending. Response fields are normalized to the same schema as the futures coin markets endpoint. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/coins-markets" \
  -H "X-My-Token: your_token" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 7.2 `GET /cexdata/spot/pairs-markets`

Returns spot market data of a base coin's trading pairs across exchanges, including price, volume, and change fields.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Trading pair base symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/pairs-markets" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 7.3 `GET /cexdata/spot/pairs-coins`

Returns spot exchange trading-pair enumeration data searched by coin symbol.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/pairs-coins" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

### 7.4 `GET /cexdata/spot/price/history`

Returns historical spot trading-pair candlestick data, including time, open, high, low, close, and volume in USD. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/price/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.5 `GET /cexdata/spot/orderbook/ask-bids-history`

Returns historical spot trading-pair orderbook ask/bid depth data for a selected exchange and trading pair, including time, bid quantity, ask quantity, bid USD amount, and ask USD amount. `startTime` and `endTime` can cover at most `300` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `depth` | `string` | **[required]** Orderbook depth difference. Only `1`, `0.75`, `0.5`, or `0.25` is supported, corresponding to `1%`, `0.75%`, `0.5%`, and `0.25%` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `12h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `300` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/orderbook/ask-bids-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "depth=1" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.6 `GET /cexdata/spot/orderbook/aggregated-ask-bids-history`

Returns historical spot aggregated coin orderbook ask/bid depth data for a selected exchange list, including time, bid quantity, ask quantity, bid USD amount, and ask USD amount. `startTime` and `endTime` can cover at most `300` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,OKX,Bybit,Coinbase`. Use `ALL` to include all exchanges |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |
| `depth` | `string` | **[required]** Orderbook depth difference. Only `1`, `0.75`, `0.5`, or `0.25` is supported, corresponding to `1%`, `0.75%`, `0.5%`, and `0.25%` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `12h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `300` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/orderbook/aggregated-ask-bids-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=ALL" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "depth=1" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.7 `GET /cexdata/spot/orderbook/history`

Returns spot orderbook history heatmap data. `startTime` and `endTime` can cover at most `20` K-lines per request.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `exchange` | `string` | **[required]** Exchange name, for example `Binance` or `OKX` |
| `pair` | `string` | **[required]** Complete trading pair, for example `BTCUSDT` or `ETHUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `1m`, `3m`, `5m`, `15m`, `30m`, `h1`, `h4`, or `d1` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp; with `endTime`, each request can cover at most `20` K-lines |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/orderbook/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "exchange=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.8 `GET /cexdata/spot/orderbook/large-limit-order-history`

Returns historical spot large limit-order data for a selected exchange and trading pair. Spot vs futures rows are split by exchange-specific rules: Binance requires `contractType` ≠ `PERPETUAL`, OKX requires `instrumentId` without `SWAP`, Coinbase is always treated as spot. Each request can fetch up to `50` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/orderbook/large-limit-order-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.9 `GET /cexdata/spot/taker-buy-sell-volume/history`

Returns historical spot trading-pair taker buy/sell volume in USD for a selected exchange and pair, including time, `taker_buy_volume_usd`, and `taker_sell_volume_usd`. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/taker-buy-sell-volume/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.10 `GET /cexdata/spot/aggregated-taker-buy-sell-volume/history`

Returns historical spot coin-level taker buy/sell volume aggregated across one or more exchanges, including time, `taker_buy_volume`, and `taker_sell_volume` measured in coin units. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/aggregated-taker-buy-sell-volume/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.11 `GET /cexdata/spot/volume/footprint-history`

Returns historical spot footprint chart data for a selected exchange and trading pair, returned as a 2D array structure. Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/volume/footprint-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.12 `GET /cexdata/spot/cvd/history`

Returns historical spot volume delta data for a selected exchange and trading pair, including time, taker buy volume, taker sell volume, and per-K-line buy minus sell volume delta (denominated in coin). Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname` | `string` | **[required]** Exchange name. Only one exchange is supported, for example `Binance` |
| `pair` | `string` | **[required]** Trading pair, for example `BTCUSDT` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/cvd/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname=Binance" \
  --data-urlencode "pair=BTCUSDT" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.13 `GET /cexdata/spot/aggregated-cvd/history`

Returns historical aggregated spot CVD data across selected exchanges, including time, taker buy volume, taker sell volume, and per-K-line buy minus sell volume delta (denominated in coin). Each request can fetch up to `300` K-lines.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[required]** Exchange names separated by commas, for example `Binance,Bybit,OKX` |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |
| `interval` | `string` | **[required]** Data interval, for example `5m`, `15m`, `30m`, `1h`, `4h`, or `1d` |
| `startTime` | `integer` | **[required]** Start time, Unix timestamp |
| `endTime` | `integer` | **[required]** End time, Unix timestamp |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/aggregated-cvd/history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "cexname_list=Binance,Bybit,OKX" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "interval=1h" \
  --data-urlencode "startTime=1776740400" \
  --data-urlencode "endTime=1777280258"
```

### 7.14 `GET /cexdata/spot/netflow-list`

Returns a spot coin-aggregated inflow/outflow list, sorted by market cap descending. Day-prefixed time fields such as `d3`/`d15`/`d30`/`d40`/`d60`/`d90`/`d120` are renamed to `3d`/`15d`/`30d`/`40d`/`60d`/`90d`/`120d`. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/netflow-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 7.15 `GET /cexdata/spot/coin/netflow`

Returns spot coin-aggregated inflow/outflow data for a single coin, expanded into per-time-window arrays.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` or `ETH` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/spot/coin/netflow" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

## 8. Coin Data

### 8.1 `GET /cexdata/coin/unlock-list`

Returns the coin token unlock schedule list, including total supply, max supply, circulating supply, total locked/unlocked, next unlock date/tokens/USD value, price, and market cap. The `logo` field is removed from each row; all other fields are preserved. `pageSize` is capped at `100`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[optional]** Page number, starts from `1`. Default: `1` |
| `pageSize` | `integer` | **[optional]** Rows per page. Default: `100`. Maximum: `100` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/coin/unlock-list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "pageNum=1" \
  --data-urlencode "pageSize=100"
```

### 8.2 `GET /cexdata/coin/vesting`

Returns the full token vesting/unlock detail for a given coin symbol, returned as-is.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol (case-insensitive; `USDT`/`USDC`/`USD`/`PERP` suffix is automatically stripped), for example `BTC` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/coin/vesting" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

## 9. Option Data

### 9.1 `GET /cexdata/option/max-pain`

Returns option max pain data by coin and exchange, returned as raw JSON.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol. Only `BTC` or `ETH` is supported |
| `cexname` | `string` | **[required]** Option exchange name. Only `Deribit`, `Binance`, or `OKX` is supported |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/option/max-pain" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "cexname=Deribit"
```

### 9.2 `GET /cexdata/option/exchange-oi-history`

Returns option exchange open interest history by coin and currency unit, returned as raw JSON.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol. Only `BTC` or `ETH` is supported |
| `currency` | `string` | **[required]** Data unit. Only `USD`, `BTC`, or `ETH` is supported |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/option/exchange-oi-history" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC" \
  --data-urlencode "currency=USD"
```

## 10. Exchange Data

### 10.1 `GET /cexdata/exchange/assets`

Returns aggregated exchange asset data including balance, leverage, open interest, volume, and inflow metrics. The `exchangeNameLogo` field is removed and `exchangeName` is renamed to `CexName`; all other fields are preserved.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/exchange/assets" \
  -H "X-My-Token: your_token"
```

### 10.2 `GET /cexdata/exchange/balance/list`

Returns on-chain exchange wallet balance list for a given coin symbol, including 24h/7d/30d balance changes and percentages. The `exLogo` field is removed, `exchangeName` is renamed to `CexName`, and `dN`-prefixed keys (e.g. `d7BalanceChange`, `d30BalanceChange`) are flipped to `Nd`-prefixed keys (e.g. `7dBalanceChange`, `30dBalanceChange`).

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `coin` | `string` | **[required]** Coin symbol, for example `BTC` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/exchange/balance/list" \
  -H "X-My-Token: your_token" \
  --data-urlencode "coin=BTC"
```

## 11. ETF Data

### 11.1 `GET /cexdata/etf/bitcoin/list`

Returns the ETF/stock list (e.g. `SPY`, `QQQ`, `IWM`, `TLT`, `GLD`) including ticker, name, market cap, close price, daily price change/percent, primary exchange, share class, volume, and USD volume.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/bitcoin/list" \
  -H "X-My-Token: your_token"
```

### 11.2 `GET /cexdata/etf/bitcoin/net-assets/history`

Returns the historical market data (including total net assets, prices, and related time series) aggregated across all Bitcoin ETFs.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/bitcoin/net-assets/history" \
  -H "X-My-Token: your_token"
```

### 11.3 `GET /cexdata/etf/bitcoin/flow-history`

Returns the historical ETF net inflow/outflow data aggregated across all Bitcoin ETFs (including per-date flow amounts and related time series).

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/bitcoin/flow-history" \
  -H "X-My-Token: your_token"
```

### 11.4 `GET /cexdata/etf/bitcoin/detail`

Returns the full detail (asset profile, holdings, fees, market data, time series, etc.) of a single ETF/stock identified by its ticker. Response is returned as-is.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `ticker` | `string` | **[required]** ETF ticker; normalized to uppercase, for example `IBIT` |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/etf/bitcoin/detail" \
  -H "X-My-Token: your_token" \
  --data-urlencode "ticker=IBIT"
```

### 11.5 `GET /cexdata/etf/ethereum/flow-history`

Returns the historical ETF net inflow/outflow data aggregated across all Ethereum ETFs (including per-date flow amounts and related time series).

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/ethereum/flow-history" \
  -H "X-My-Token: your_token"
```

### 11.6 `GET /cexdata/etf/ethereum/list`

Returns the Ethereum ETF list (e.g. `ETHA`, `FETH`, `ETHE`, `ETH`, `ETHW`, `ETHV`) including ticker, name, market cap, close price, daily price change/percent, primary exchange, share class, volume, and USD volume.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/ethereum/list" \
  -H "X-My-Token: your_token"
```

### 11.7 `GET /cexdata/etf/solana/flow-history`

Returns the historical ETF net inflow/outflow data aggregated across all Solana ETFs (including per-date flow amounts and related time series).

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/solana/flow-history" \
  -H "X-My-Token: your_token"
```

### 11.8 `GET /cexdata/etf/solana/list`

Returns the Solana ETF list (e.g. `SOLZ`, `SOLT`, and other Solana-linked ETFs/ETPs) including ticker, name, market cap, close price, daily price change/percent, primary exchange, share class, volume, and USD volume.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/solana/list" \
  -H "X-My-Token: your_token"
```

### 11.9 `GET /cexdata/etf/xrp/flow-history`

Returns the historical ETF net inflow/outflow data aggregated across all XRP ETFs (including per-date flow amounts and related time series).

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/xrp/flow-history" \
  -H "X-My-Token: your_token"
```

### 11.10 `GET /cexdata/etf/xrp/list`

Returns the XRP ETF list (e.g. `XRPI`, `XRPT`, and other XRP-linked ETFs/ETPs) including ticker, name, market cap, close price, daily price change/percent, primary exchange, share class, volume, and USD volume.

### Path Parameters

None

### Query Parameters

None

### Example

```bash
curl "http://0xrouter.app/cexdata/etf/xrp/list" \
  -H "X-My-Token: your_token"
```

## 12. Economic Calendar

### 12.1 `GET /cexdata/calendar/economic-data`

Returns economic calendar events (e.g. `CPI`, `PPI`, `GDP`, employment data, central bank decisions) including indicator id, name, country code/name, data status, scheduled time, previous/estimate/published values, importance star rating, and `locale`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `locale` | `string` | **[required]** Language. Only `en` or `zh` is supported. Default: `zh` |
| `startTime` | `integer` | **[required]** Start time, millisecond Unix timestamp; defaults to `00:00:00` of the server's local current day when omitted |
| `endTime` | `integer` | **[required]** End time, millisecond Unix timestamp; defaults to `23:59:59` of the server's local current day when omitted |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/calendar/economic-data" \
  -H "X-My-Token: your_token" \
  --data-urlencode "locale=zh" \
  --data-urlencode "startTime=1776700800000" \
  --data-urlencode "endTime=1776787199000"
```

### 12.2 `GET /cexdata/calendar/financial-events`

Returns financial calendar events (e.g. Trump speeches, policy announcements, and other macro/market-moving events) including event id, name, country code/name, publication time, publication status, importance star rating, event type, and `locale`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `locale` | `string` | **[required]** Language. Only `en` or `zh` is supported. Default: `zh` |
| `startTime` | `integer` | **[required]** Start time, millisecond Unix timestamp; defaults to `00:00:00` of the server's local current day when omitted |
| `endTime` | `integer` | **[required]** End time, millisecond Unix timestamp; defaults to `23:59:59` of the server's local current day when omitted |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/calendar/financial-events" \
  -H "X-My-Token: your_token" \
  --data-urlencode "locale=zh" \
  --data-urlencode "startTime=1776700800000" \
  --data-urlencode "endTime=1776787199000"
```

### 12.3 `GET /cexdata/calendar/central-bank-activities`

Returns central bank calendar activities (e.g. Fed/ECB/BOE/BOJ officials' speeches, press conferences, and other central bank events) including event id, name, country code/name, publication time, publication status, importance star rating, event type, and `locale`.

### Path Parameters

None

### Query Parameters

| Name | Type | Description |
| :--- | :--- | :--- |
| `locale` | `string` | **[required]** Language. Only `en` or `zh` is supported. Default: `zh` |
| `startTime` | `integer` | **[required]** Start time, millisecond Unix timestamp; defaults to `00:00:00` of the server's local current day when omitted |
| `endTime` | `integer` | **[required]** End time, millisecond Unix timestamp; defaults to `23:59:59` of the server's local current day when omitted |

### Example

```bash
curl --get "http://0xrouter.app/cexdata/calendar/central-bank-activities" \
  -H "X-My-Token: your_token" \
  --data-urlencode "locale=zh" \
  --data-urlencode "startTime=1776700800000" \
  --data-urlencode "endTime=1776787199000"
```

## 13. Status Codes

| Status code | Meaning | Charged |
| :--- | :--- | :--- |
| `200` | Request succeeded | Counted as a valid call under validity-based authorization; not charged by response size |
| `400` | Group not allowed, missing/invalid parameters, K-line row count exceeded, or upstream parameter error | No |
| `401` | Missing or invalid token | No |
| `402` | Insufficient balance | No |
| `403` | IP banned, token invalid, or token blocked | No |
| `429` | Token rate limit exceeded | No |
| `502` | Gateway retries exhausted | No |
| `503` | All gateway nodes are cooling down | No |

## 14. Recommendations

Recommended integration order:

1. Verify the token with `/account/balance/cexdata` first to confirm the project is enabled and not expired.
2. Then call lightweight directory endpoints such as `/cexdata/futures/cexdexlist` and `/cexdata/futures/coins-markets`.
3. Finally integrate higher-throughput endpoints such as K-line, orderbook, liquidation, and footprint history.