> For the complete documentation index, see [llms.txt](https://docs.bbx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bbx.com/zhs/bbx-dex-public-api/gai-shu.md).

# 概述

本文档介绍 BBX DEX 为第三方市场数据集成提供的公开市场数据端点。

BBX DEX 针对所支持的数据平台分别提供集成端点，包括 CoinMarketCap 和 CoinGecko。这些集成使用相同的 BBX 底层市场数据基础设施，但其端点路径、字段名称、时间戳规则、响应格式以及适用的市场覆盖范围可能有所不同。

有关各平台专用端点的定义和响应结构，请参阅对应的集成章节。

这些端点具有以下特点：

* 只读
* 可公开访问
* 以 JSON 格式返回数据
* 无需 API 密钥、请求签名、登录凭证、身份验证令牌或自定义请求头

> 第三方平台仅可接入其自身收录和市场映射系统所支持的市场及交易标的。

***

### 基础 URL

```
https://dex.bbx.com
```

### 支持的集成

BBX DEX 目前为以下第三方平台提供公开市场数据集成端点：

| 集成平台          | 当前市场范围 | API 前缀                                                         |
| ------------- | ------ | -------------------------------------------------------------- |
| CoinMarketCap | 现货及期货  | `/sapi/v4/market/v1/public/cmc` 和 `/fapi/market/v1/public/cmc` |
| CoinGecko     | 加密货币期货 | `/fapi/market/v1/public/coingecko`                             |

各项集成均使用相同的 BBX 底层市场数据基础设施，但可能采用不同的端点路径、字段名称、时间戳规则、响应格式以及市场适用规则。

有关各平台专用端点的定义和响应结构，请参阅对应的集成章节。

***

### 通用约定

| 项目    | 约定                                |
| ----- | --------------------------------- |
| 身份验证  | 无                                 |
| 响应格式  | JSON                              |
| 传输协议  | HTTPS                             |
| 访问类型  | 公开、只读                             |
| 数值精度  | 价格、交易量、费率及其他小数值可能以字符串形式返回         |
| 时间戳   | 以 JSON 整数形式返回；适用的时间单位将在对应的集成章节中说明 |
| 市场标识符 | 交易对命名规则将在对应的集成章节中说明               |

***

### 数据一致性

公开集成端点与 BBX 交易界面使用相同的 BBX 底层市场数据基础设施。

不同平台的专用端点可能采用不同的字段名称、时间戳单位和响应结构，但底层市场数据，包括价格、交易量、订单簿、未平仓量、指数价格和资金费率，均来源于 BBX 的市场数据系统。

由于 API 与网站独立更新，两者之间可能存在轻微的时间差异。

***

### 可用性

这些端点旨在支持常规的自动化市场数据轮询。

为维护公共 API 服务的稳定性，BBX 可能采用合理的速率限制、流量控制或可用性保护措施。相关措施旨在保障第三方市场数据集成的正常使用。

***

### 文档章节

* CoinMarketCap 集成
* CoinGecko 集成
* 错误处理
* 数据完整性与可用性
* 更新日志