# 聚合交易所数据 API 接入说明

## 1. 基本信息

- Base URL: `http://0xrouter.app`
- 请求方法: `GET`
- 鉴权 Header: `X-My-Token`
- 返回格式: `JSON`
- 平台标识: `cexdata`

所有请求都需要带上：

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

补充说明：

- 聚合交易所数据接口基于网页端数据源整理，接口路径、参数和返回结构与上游官方 Open API 不一致，请以本文档为准。
- 文档里支持多值的参数按英文逗号分隔传递，例如 `cexname_list=Binance,Bybit,OKX`；标注为单个交易所的 `cexname` 不支持逗号传多值，传入会在请求处理前直接返回 `400`。
- 本服务当前统一要求 `X-My-Token`，即使个别接口对匿名访问保持兼容。
- 网页端数据源可能随上游页面变化而调整，建议调用方对 `data` 内字段做容错读取。
- 历史 K 线类接口单次最多拉取 `300` 根 K 线；订单薄历史热力图单次最多覆盖 `20` 根；大额订单薄历史最多 `50` 根。超出范围会在请求上游前直接返回 `400`。
- 关于 `pair` 与 `coin` 参数：本文档把"币种 vs 交易对"统一区分成 `pair`（交易对，如 `BTCUSDT`）和 `coin`（币种，如 `BTC`）两种参数名。带单交易所 `cexname` 的接口用 `pair`，按币种聚合或不限交易所的接口用 `coin`。**旧的 `symbol` 参数名永久兼容**——即使后端文档已改用 `pair`/`coin`，调用 `?symbol=...` 仍按相同语义生效。

## 2. 授权、计费与频率

### 2.1 授权方式

聚合交易所数据当前按有效期 + 限频方式开通：

- 启用账号可在有效期内调用已授权接口。
- 每个 token 有独立的项目级限频。
- 项目过期、未启用或账号封禁时会返回权限错误。
- CexData 自定义接口会按接口路径与查询参数缓存成功响应 `20` 秒，用于降低重复请求流量。

### 2.2 计费规则

- 当前建议按有效期授权，不按单次响应大小扣点。
- 鉴权失败、未开通、已到期、上游失败、最终请求失败等情况不应计为有效调用。
- 如后续改为点数或混合计费，以控制台显示和管理员配置为准。

### 2.3 频率说明

- 默认频率以后台给用户配置的 `rate_limit_per_minute` 为准。
- 聚合交易所数据接口通常比链上情报接口更适合高频轮询，但仍建议对热点接口做本地缓存。
- 对资金费率、持仓、爆仓、多空比等高频接口，建议按业务需要设置合理轮询间隔。

## 3. 当前开放分组

| 分组 | 路径前缀 | 说明 |
| :--- | :--- | :--- |
| Calendar | `/cexdata/calendar/*` | 经济日历、财经事件、央行活动 |
| Coin | `/cexdata/coin/*` | 币种解锁列表与解锁详情 |
| ETF | `/cexdata/etf/*` | BTC / ETH / SOL / XRP ETF 列表、净资产历史、资金流入流出 |
| Exchange | `/cexdata/exchange/*` | 交易所资产汇总与币种链上钱包余额 |
| Futures | `/cexdata/futures/*` | 合约市场、K 线、资金费率、多空比、爆仓、订单薄、主动买卖等 |
| Option | `/cexdata/option/*` | 期权最大痛点、各交易所持仓量历史 |
| Spot | `/cexdata/spot/*` | 现货市场、K 线、订单薄、主动买卖、流入流出等 |

## 4. 接口目录（按首字母正序）

下方目录按接口分组首字母正序排列。第 5 节的账户接口属于本站管理接口，单独保留。

#### 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. 账户接口

### 5.1 `GET /account/balance`

返回当前 token 在所有平台下的余额、项目权限、封禁状态、到期时间和限频配置。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

返回指定平台的余额、项目权限、封禁状态、到期时间和限频配置。

### 路径参数 (Path Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `platform` | `string` | **[必填]** 平台名，聚合交易所数据当前可用值为 `cexdata` |

### 查询参数 (Query Parameters)

无

### 示例

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

### 5.3 `GET /account/usage`

查询当前 Token 的调用日志、扣点、响应大小、耗时和分页信息。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `platform` | `string` | **[可选]** 按平台过滤，例如 `cexdata` |
| `start` | `string` | **[可选]** 开始时间，Unix 时间戳或日期 |
| `end` | `string` | **[可选]** 结束时间，Unix 时间戳或日期 |
| `page` | `integer` | **[可选]** 页码，从 `1` 开始 |
| `limit` | `integer` | **[可选]** 返回条数，非管理员最大 `100` |

### 示例

```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. 合约数据

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

获取 Hyperliquid 鲸鱼动作提醒数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取 Hyperliquid 鲸鱼持仓数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

按币种名称过滤 Hyperliquid 鲸鱼持仓数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

```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`

按币种名称获取 Hyperliquid 清算地图数据。本服务会过滤掉 list 行的 `id`、`isFavorite`、`price` 字段，并把 `userId` 改名为 `hypeaddress`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

```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`

获取目前支持的合约 CEX / DEX 交易所列表，以及相关合约全局数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

按交易所名称查询该交易所的合约交易对。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance`；不要用逗号传入多个交易所 |

### 示例

```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`

按币种名称搜索合约交易所交易对枚举数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

```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`

按一个或多个交易所名称查询合约市场数据，包含价格、成交量、持仓量、多空比和市场结构等字段。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按基础币种查询该币种在各交易所的合约市场数据，包含价格、成交量、持仓量和涨跌幅等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 交易对基础币种，例如 `BTC`、`ETH` |

### 示例

```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`

获取交易对历史 K 线数据，包含时间、开盘价、最高价、最低价、收盘价和成交额。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `m5`/`5m`、`m15`/`15m`、`m30`/`30m`、`h1`/`1h`、`h4`/`4h`、`d1`/`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对历史持仓量 K 线数据，包含时间、开盘持仓量、最高持仓量、最低持仓量和收盘持仓量。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的 USDT 本位合约持仓量历史 K 线数据，包含时间、开盘持仓量、最高持仓量、最低持仓量和收盘持仓量。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称或交易对，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的币本位合约持仓量历史 K 线数据，包含时间、开盘持仓量、最高持仓量、最低持仓量和收盘持仓量。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对历史资金费率 K 线数据，包含时间、开盘资金费率、最高资金费率、最低资金费率和收盘资金费率。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对持仓加权平均费率历史 K 线数据，包含时间、开盘资金费率、最高资金费率、最低资金费率和收盘资金费率。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间,Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间,Unix 时间戳 |

### 示例

```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`

获取合约资金费率套利列表数据。可选 `cexname` 默认为 `all`（全交易所）。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[可选]** 交易所名称，默认为 `all`（所有交易所） |

### 示例

```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`

获取合约资金费率利息套利数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

```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`

获取交易对账户多空比历史 K 线数据，包含时间、开盘多空比、最高多空比、最低多空比和收盘多空比。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对大账户多空比历史 K 线数据，包含时间、开盘多空比、最高多空比、最低多空比和收盘多空比。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对大账户持仓多空比历史 K 线数据，包含时间、开盘多空比、最高多空比、最低多空比和收盘多空比。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易所与交易对的聚合币种主动买卖比历史折线数据，包含时间和主动买卖比。单次最多拉取 `300` 根折线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对净多持仓与净空持仓历史 K 线数据。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对净多持仓与净空持仓 v2 历史 K 线数据。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取交易对爆仓历史数据，包含时间、空单爆仓 USDT 金额和多单爆仓 USDT 金额。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取币种聚合爆仓历史数据，包含时间、空单爆仓 USDT 金额和多单爆仓 USDT 金额。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所的合约币种爆仓排行列表，包含币种名称、爆仓总金额、多单爆仓金额、空单爆仓金额（USDT）等字段，按 `interval` 时间窗口降序排序。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `1h`、`4h`、`12h`、`24h` |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按币种获取各交易所爆仓时序数据。每个时间点包含价格、`All` 汇总以及各交易所的多/空爆仓金额（USD）。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |
| `interval` | `string` | **[可选]** 数据时间间隔，只支持 `1m`、`5m`、`15m`、`30m`、`1h`、`4h`、`12h`、`all`；默认 `all` |

### 示例

```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`

获取合约爆仓最大痛点数据，包含价格、多单风险、空单风险与多空爆仓最大金额及对应价格。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `range` | `string` | **[必填]** 时间范围，只支持 `12h`、`24h`、`48h`、`3d`、`7d`、`14d`、`30d` |

### 示例

```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`

获取最新的合约爆仓订单列表。响应只保留 `data.list` 数组，并删除 `exchangeLogo`、`symbolLogo` 字段，`exchangeName` 重命名为 `cexname`。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `volUsd` | `string` | **[必填]** 爆仓订单最小金额阈值，例如 `10000` |
| `coin` | `string` | **[可选]** 币种名称，留空表示不限，例如 `BTC` |
| `cexname` | `string` | **[可选]** 交易所名称，留空表示不限，例如 `Binance` |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

获取交易对清算热力图数据。`range` 自动映射时间间隔与数据条数。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `pair` | `string` | **[必填]** 完整交易对，例如 `BTCUSDT`、`ETHUSDT` |
| `cexname` | `string` | **[必填]** 交易所名称，例如 `Binance`、`OKX` |
| `range` | `string` | **[必填]** 时间范围，只支持 `12h`、`1d`、`2d`、`3d`，大小写均可 |

### 示例

```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`

获取聚合币种清算热力图数据。`range` 自动映射时间间隔与数据条数。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |
| `range` | `string` | **[必填]** 时间范围，只支持 `12h`、`1d`、`2d`、`3d`，大小写均可 |

### 示例

```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`

获取指定交易所与完整交易对的清算地图数据。`range` 自动映射时间间隔与数据条数。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `exchange` | `string` | **[必填]** 交易所名称，例如 `Binance`、`OKX` |
| `pair` | `string` | **[必填]** 完整交易对，例如 `ETHUSDT`、`BTCUSDT` |
| `range` | `string` | **[必填]** 时间范围，只支持 `1d`、`7d`、`30d`，大小写均可 |

### 示例

```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`

获取聚合币种清算地图数据。`range` 自动映射时间间隔与数据条数。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |
| `range` | `string` | **[必填]** 时间范围，只支持 `1d`、`7d`、`30d`，大小写均可 |

### 示例

```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`

获取指定交易所与合约交易对的挂单深度历史数据，包含时间、多单总数量、空单总数量、多单总金额和空单总金额。`startTime` 与 `endTime` 单次最多覆盖 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `depth` | `string` | **[必填]** 盘口深度差值，只支持 `1`、`0.75`、`0.5`、`0.25`，对应 `1%`、`0.75%`、`0.5%`、`0.25%` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `1m`、`5m`、`15m`、`30m`、`1h`、`4h`、`12h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `300` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

按交易所列表获取币种聚合合约挂单深度历史数据，包含时间、多单总数量、空单总数量、多单总金额和空单总金额。`startTime` 与 `endTime` 单次最多覆盖 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX,Deribit` |
| `coin` | `string` | **[必填]** 币种名称，例如 `ZEC`、`BTC`、`ETH` |
| `depth` | `string` | **[必填]** 盘口深度差值，只支持 `1`、`0.75`、`0.5`、`0.25`，对应 `1%`、`0.75%`、`0.5%`、`0.25%` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `1m`、`5m`、`15m`、`30m`、`1h`、`4h`、`12h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `300` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取订单薄历史热力图数据。`startTime` 与 `endTime` 单次最多覆盖 `20` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `exchange` | `string` | **[必填]** 交易所名称，例如 `Binance`、`OKX` |
| `pair` | `string` | **[必填]** 完整交易对，例如 `BTCUSDT`、`ETHUSDT` |
| `interval` | `string` | **[必填]** 时间间隔，例如 `1m`、`3m`、`5m`、`15m`、`30m`、`h1`、`h4`、`d1` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `20` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与交易对的大额订单薄历史数据。单次最多拉取 `50` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与交易对的主动买入/卖出成交额历史数据。`interval` 使用与其他历史接口一致的 K 线格式，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的币种主动买入/卖出数量历史数据。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与交易对的足迹图历史数据，返回二维数组结构。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与交易对的 CVD 历史数据，包含时间、主动买入量、主动卖出量和每根 K 线买卖差值。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的币种 CVD 历史数据，包含时间、主动买入量、主动卖出量和每根 K 线买卖差值。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取币种聚合流入流出列表，按市值降序排序。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按币种查询合约聚合流入流出数据，按时间窗口展开为数组。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

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

## 7. 现货数据

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

获取现货币种市场列表，按市值降序排序。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按基础币种查询该币种在各交易所的现货市场数据，包含价格、成交量和涨跌幅等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 交易对基础币种，例如 `BTC`、`ETH` |

### 示例

```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`

按币种名称搜索现货交易所交易对枚举数据。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

```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`

获取指定交易所与现货交易对的价格历史 K 线数据，包含时间、开盘价、最高价、最低价、收盘价和成交额。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与现货交易对的挂单深度历史数据，包含时间、多单总数量、空单总数量、多单总金额和空单总金额。`startTime` 与 `endTime` 单次最多覆盖 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `depth` | `string` | **[必填]** 盘口深度差值，只支持 `1`、`0.75`、`0.5`、`0.25`，对应 `1%`、`0.75%`、`0.5%`、`0.25%` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `1m`、`5m`、`15m`、`30m`、`1h`、`4h`、`12h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `300` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

按交易所列表获取币种聚合现货挂单深度历史数据，包含时间、多单总数量、空单总数量、多单总金额和空单总金额。`startTime` 与 `endTime` 单次最多覆盖 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,OKX,Bybit,Coinbase`，可填 `ALL` 表示所有 |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |
| `depth` | `string` | **[必填]** 盘口深度差值，只支持 `1`、`0.75`、`0.5`、`0.25`，对应 `1%`、`0.75%`、`0.5%`、`0.25%` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `1m`、`5m`、`15m`、`30m`、`1h`、`4h`、`12h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `300` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取现货订单薄历史热力图数据。`startTime` 与 `endTime` 单次最多覆盖 `20` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `exchange` | `string` | **[必填]** 交易所名称，例如 `Binance`、`OKX` |
| `pair` | `string` | **[必填]** 完整交易对，例如 `BTCUSDT`、`ETHUSDT` |
| `interval` | `string` | **[必填]** 时间间隔，例如 `1m`、`3m`、`5m`、`15m`、`30m`、`h1`、`h4`、`d1` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳；与 `endTime` 单次最多覆盖 `20` 根 K 线 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与现货交易对的大额订单薄历史数据。现货与合约按交易所规则区分：Binance 要求 `contractType` ≠ `PERPETUAL`，OKX 要求 `instrumentId` 不带 `SWAP`，Coinbase 全部视为现货。单次最多拉取 `50` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与现货交易对的主动买入/卖出成交额历史数据，包含时间、主动买入金额（USD）和主动卖出金额（USD）。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的币种现货主动买入/卖出数量历史数据，包含时间、主动买入数量和主动卖出数量（按币计量）。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与现货交易对的足迹图历史数据，返回二维数组结构。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取指定交易所与现货交易对的 CVD 历史数据，包含时间、主动买入量、主动卖出量和每根 K 线买卖差值（按币计量）。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname` | `string` | **[必填]** 交易所名称，只支持单个交易所，例如 `Binance` |
| `pair` | `string` | **[必填]** 交易对，例如 `BTCUSDT` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取一个或多个交易所聚合后的币种现货 CVD 历史数据，包含时间、主动买入量、主动卖出量和每根 K 线买卖差值（按币计量）。单次最多拉取 `300` 根 K 线。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `cexname_list` | `string` | **[必填]** 交易所名称列表，多个用英文逗号分隔，例如 `Binance,Bybit,OKX` |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |
| `interval` | `string` | **[必填]** 数据时间间隔，例如 `5m`、`15m`、`30m`、`1h`、`4h`、`1d` |
| `startTime` | `integer` | **[必填]** 开始时间，Unix 时间戳 |
| `endTime` | `integer` | **[必填]** 结束时间，Unix 时间戳 |

### 示例

```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`

获取现货币种聚合流入流出列表，按市值降序排序。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按币种查询现货聚合流入流出数据，按时间窗口展开为数组。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC`、`ETH` |

### 示例

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

## 8. 币种数据

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

获取币种解锁计划列表，包含总供应量、流通量、已解锁/未解锁数量、下次解锁时间/数量/USD 价值、当前价格与市值等字段。`pageSize` 最大 `100`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `pageNum` | `integer` | **[可选]** 页码，从 `1` 开始，默认 `1` |
| `pageSize` | `integer` | **[可选]** 每页条数，默认 `100`，最大 `100` |

### 示例

```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`

按币种查询完整的解锁/释放计划详情，按原版 JSON 透传。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称（不区分大小写，自动剥离 `USDT`/`USDC`/`USD`/`PERP` 后缀），例如 `BTC` |

### 示例

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

## 9. 期权数据

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

按币种与期权交易所查询期权最大痛点数据，原始 JSON 透传。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，只支持 `BTC`、`ETH` |
| `cexname` | `string` | **[必填]** 期权交易所名称，只支持 `Deribit`、`Binance`、`OKX` |

### 示例

```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`

按币种与数据单位查询期权各交易所持仓量历史数据，按原版 JSON 透传。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，只支持 `BTC`、`ETH` |
| `currency` | `string` | **[必填]** 数据单位，只支持 `USD`、`BTC`、`ETH` |

### 示例

```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. 交易所数据

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

获取交易所资产汇总数据，包含交易所余额、平均杠杆、持仓量、成交量与资金流入/流出等指标。响应中删除 `exchangeNameLogo`，并把 `exchangeName` 重命名为 `CexName`。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

按币种查询各交易所链上钱包余额列表，包含余额、当前/`7`日/`30`日变动量及变动百分比。响应中删除 `exLogo`，`exchangeName` 重命名为 `CexName`，并把 `dN` 前缀的字段（如 `d7BalanceChange`、`d30BalanceChange`）改写为 `Nd` 前缀（`7dBalanceChange`、`30dBalanceChange`）。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `coin` | `string` | **[必填]** 币种名称，例如 `BTC` |

### 示例

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

## 11. ETF 数据

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

获取 ETF/股票列表（如 `SPY`、`QQQ`、`IWM`、`TLT`、`GLD` 等），包含 `ticker`、名称、市值、收盘价、价格变动量与百分比、主交易所、股份代码、成交量、成交额等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取全市场比特币 ETF 聚合的历史行情数据，包含总净资产、价格等时间序列字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

```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`

获取全市场比特币 ETF 聚合的历史净资金流入/流出数据，按日期给出资金流动金额等时间序列字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

按 `ticker` 查询单个 ETF/股票的完整详情数据（包含资产画像、持仓、费率、行情、时间序列等），按原版 JSON 透传。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `ticker` | `string` | **[必填]** ETF 代码，自动转大写，例如 `IBIT` |

### 示例

```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`

获取全市场以太坊 ETF 聚合的历史净资金流入/流出数据，按日期给出资金流动金额等时间序列字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取以太坊 ETF 列表（如 `ETHA`、`FETH`、`ETHE`、`ETH`、`ETHW`、`ETHV` 等），包含 `ticker`、名称、市值、收盘价、价格变动量与百分比、主交易所、股份代码、成交量、成交额等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取全市场 Solana ETF 聚合的历史净资金流入/流出数据，按日期给出资金流动金额等时间序列字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取 Solana ETF 列表（如 `SOLZ`、`SOLT` 及其他 Solana 相关 ETF/ETP），包含 `ticker`、名称、市值、收盘价、价格变动量与百分比、主交易所、股份代码、成交量、成交额等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取全市场 XRP ETF 聚合的历史净资金流入/流出数据，按日期给出资金流动金额等时间序列字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

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

获取 XRP ETF 列表（如 `XRPI`、`XRPT` 及其他 XRP 相关 ETF/ETP），包含 `ticker`、名称、市值、收盘价、价格变动量与百分比、主交易所、股份代码、成交量、成交额等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

无

### 示例

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

## 12. 经济日历

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

获取经济日历事件数据（如 `CPI`、`PPI`、`GDP`、就业数据、各国央行决议等），包含指标 ID、名称、国家代码/名称、数据状态、发布时间、前值/预期值/公布值、重要性星级、`locale` 等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `locale` | `string` | **[必填]** 语言，只支持 `en`、`zh`，默认 `zh` |
| `startTime` | `integer` | **[必填]** 开始时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `00:00:00` |
| `endTime` | `integer` | **[必填]** 结束时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `23:59:59` |

### 示例

```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`

获取财经事件日历数据（如特朗普等要人讲话、政策发布等对市场有影响的宏观事件），包含事件 ID、名称、国家代码/名称、发布时间、发布状态、重要性星级、事件类型、`locale` 等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `locale` | `string` | **[必填]** 语言，只支持 `en`、`zh`，默认 `zh` |
| `startTime` | `integer` | **[必填]** 开始时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `00:00:00` |
| `endTime` | `integer` | **[必填]** 结束时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `23:59:59` |

### 示例

```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`

获取央行活动日历数据（如美联储/欧央行/英央行/日央行等官员讲话、新闻发布会等央行事件），包含事件 ID、名称、国家代码/名称、发布时间、发布状态、重要性星级、事件类型、`locale` 等字段。

### 路径参数 (Path Parameters)

无

### 查询参数 (Query Parameters)

| 参数名 | 类型 | 描述 |
| :--- | :--- | :--- |
| `locale` | `string` | **[必填]** 语言，只支持 `en`、`zh`，默认 `zh` |
| `startTime` | `integer` | **[必填]** 开始时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `00:00:00` |
| `endTime` | `integer` | **[必填]** 结束时间，毫秒级 Unix 时间戳；不传时默认服务器本地当日 `23:59:59` |

### 示例

```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. 状态码

| 状态码 | 含义 | 是否扣费 |
| :--- | :--- | :--- |
| `200` | 请求成功 | 按授权方式记录有效调用，不按响应大小扣点 |
| `400` | 分组不允许、参数缺失/非法、超出 K 线行数上限或上游参数错误 | 否 |
| `401` | 缺少 Token 或 Token 无效 | 否 |
| `402` | 余额不足 | 否 |
| `403` | IP 已封禁、Token 非法或 Token 已封禁 | 否 |
| `429` | Token 触发限频 | 否 |
| `502` | 代理重试后仍失败 | 否 |
| `503` | 所有代理节点都在冷却 | 否 |

## 14. 风控与使用建议

推荐联调顺序：

1. 先用 `/account/balance/cexdata` 验证 token 可用、项目已开通且未到期
2. 再调 `/cexdata/futures/cexdexlist`、`/cexdata/futures/coins-markets` 这类轻量目录类接口
3. 最后再接 K 线、订单薄、爆仓、足迹图等高吞吐接口