市场数据总览 (Market Data)
ZTDX 提供全面的行情接口,包括公开的实时价格、订单簿深度、最新成交及 K 线数据。
数据来源
系统目前统一集成 Hyperliquid 作为核心外部数据源,通过高性能后端直接代理其 L2 深度和价格数据,为全平台提供统一、透明的行情参考。
接口分类
1. 聚合接口 (External API) - 推荐使用
这些接口经过高度优化,专门为前端和高频策略设计,路径以 /api/v1/external 为前缀。
| 接口 | 描述 | 路径 |
|---|---|---|
| 市场列表 | 获取所有可交易对概况 | GET /external/markets |
| 实时行情 | 24h Ticker 信息 | GET /external/markets/:symbol/ticker |
| 订单簿 | 实时深度数据 | GET /external/markets/:symbol/orderbook |
| 最新成交 | 市场最近成交历史 | GET /external/markets/:symbol/trades |
| K 线历史 | 历史蜡烛图数据 | GET /external/markets/:symbol/candles |
2. 标准接口
基础的市场数据接口。
| 接口 | 描述 | 路径 |
|---|---|---|
| 实时价格 | 标记价格与指数价格 | GET /markets/:symbol/price |
| 资金费率 | 当前预测及历史费率 | GET /funding-rates |
交易对格式
API 内部统一使用 无分隔符 格式,例如:BTCUSDT, ETHUSDT。
前端通常会进行转换(如 BTC-USD -> BTCUSDT)。