> 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/coingecko-ji-cheng/gai-shu.md).

# 概述

本节介绍 BBX DEX 为 CoinGecko 衍生品交易所集成提供的公开市场数据端点。

当前集成范围仅包括 BBX 支持的加密货币永续合约市场。现货市场及非加密资产交易标的，包括代币化股票、股票合约、ETF、指数和商品，均不在本次集成范围内。

所有端点均为只读、可公开访问，并且无需 API 密钥、请求签名、登录凭证、身份验证令牌或自定义请求头。

### 基础 URL

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

### 端点概览

| 数据      | 请求方法  | 端点                                           |
| ------- | ----- | -------------------------------------------- |
| 合约与合约规格 | `GET` | `/fapi/market/v1/public/coingecko/contracts` |
| 合约订单簿   | `GET` | `/fapi/market/v1/public/coingecko/orderbook` |

`Contracts` 端点将 CoinGecko 对 `Contracts` 和 `Contract Specs` 的要求合并至同一个响应中。

### 支持的市场

CoinGecko 集成端点返回 BBX 为 CoinGecko 集成提供的当前有效加密货币永续合约市场。

以下市场不会包含在返回数据中：

* 已下架或已禁用的合约
* 现货市场
* 代币化股票和股票合约
* ETF 和指数
* 商品
* 其他非加密资产交易标的

### 通用约定

| 项目      | 约定                                |
| ------- | --------------------------------- |
| 身份验证    | 无                                 |
| 访问类型    | 公开、只读                             |
| 响应格式    | 纯 JSON；成功响应不包含外层封装结构              |
| 数值      | 价格、交易量、未平仓量和费率均以字符串形式返回           |
| 时间戳     | 以 JSON 整数形式返回                     |
| 合约标识符   | 采用 `BASE-TARGET` 格式，例如 `BTC-USDT` |
| 资金费率时间戳 | Unix 秒级时间戳                        |
| 订单簿时间戳  | Unix 毫秒级时间戳                       |

### API 访问与轮询

这些端点旨在支持常规的自动化市场数据轮询，包括 CoinGecko 每分钟一次的轮询。

为维护公共 API 服务的稳定性和可用性，BBX 可能采用合理的速率限制和流量控制措施。

### 文档

有关端点定义、请求参数、响应字段和响应示例，请参阅以下页面：

* 合约与合约规格
* 合约订单簿