行情
描述
获取产品的最新成交价、买一价、卖一价和24小时交易量等信息,有变化(成交、买一卖一发)时:
- 现货推送频率:200-300ms
- 合约推送频率:300-400ms
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "spot",
"topic": "ticker",
"symbol": "BTCUSDT"
}
]
}
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| op | String | 是 | 操作subscribe 订阅 unsubscribe 退订 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型spot 现货交易usdt-futures USDT合约coin-futures 币本位合约usdc-futures USDC合约 |
| > topic | String | 是 | 频道名ticker 行情频道 |
| > symbol | String | 是 | 交易对名称 例如 BTCUSDT |
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "spot",
"topic": "ticker",
"symbol": "BTCUSDT"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > instType | String | 产品线类型spot 现货交易usdt-futures USDT合约coin-futures 币本位合约usdc-futures USDC合约 |
| > topic | String | 频道名 ticker行情频道 |
| > symbol | String | 交易对名称 |
| code | String | 错误码 |
| msg | String | 错误消息 |
推送返回示例
{
"data": [
{
"bid1Price": "99999",
"lowPrice24h": "98200",
"ask1Size": "188.312553",
"volume24h": "37.722858",
"price24hPcnt": "0.01833",
"highPrice24h": "100000",
"turnover24h": "3750302.979626",
"bid1Size": "186.183209",
"ask1Price": "100000",
"openPrice24h": "0",
"lastPrice": "100000"
}
],
"arg": {
"instType": "spot",
"symbol": "BTCUSDT",
"topic": "ticker"
},
"action": "snapshot",
"ts": 1736371332162
}
推送数据参数
现货推送
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| arg | Object | 订阅频道 |
| > instType | String | 产品线类型spot 现货交易 |
| > topic | String | 频道名ticker行情频道 |
| > symbol | Strin | 交易对名称 |
| action | String | 推送数据动作snapshot全量 update 增量 |
| data | List<String> | 订阅的数据 |
| >highPrice24h | String | 24小时最高价 |
| >lowPrice24h | String | 24小时最低价 |
| >openPrice24h | String | 24小时前的市场价格 |
| >lastPrice | String | 最新价 |
| >turnover24h | String | 24小时成交额 |
| >volume24h | String | 24小时成交量 |
| >bid1Price | String | 买一价 |
| >ask1Price | String | 卖一价 |
| >bid1Size | String | 买一量 |
| >ask1Size | String | 卖一量 |
| >price24hPcnt | String | 24小时价格涨跌幅 |
合约推送
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| arg | Object | 订阅成功频道 |
| > instType | String | 产品线类型usdt-futures USDT合约coin-futures 币本位合约usdc-futures USDC合约 |
| > topic | String | 频道名ticker行情频道 |
| action | String | 推送数据动作snapshot全量 update 增量 |
| data | List<String> | 订阅的数据 |
| >highPrice24h | String | 24小时最高价 |
| >lowPrice24h | String | 24小时最低价 |
| >openPrice24h | String | 24小时前的市场价格 |
| >lastPrice | String | 最新价 |
| >turnover24h | String | 24小时成交额 |
| >volume24h | String | 24小时成交量 |
| >bid1Price | String | 买一价 |
| >ask1Price | String | 卖一价 |
| >bid1Size | String | 买一量 |
| >ask1Size | String | 卖一量 |
| >price24hPcnt | String | 24小时价格涨跌幅 |
| >indexPrice | String | 指数价格 |
| >markPrice | String | 标记价格 |
| >fundingRate | String | 当前资金费率 |
| >nextFundingTime | String | 下次资金费率结算时间 |
| >openInterest | String | 当前平台总持仓量 |
| >deliveryTime | String | 交割时间 |
| >deliveryStartTime | String | 交割开始时间 |
| >deliveryStatus | String | 交割状态 delivery_config_period配置中 delivery_normal正常 delivery_before待交割 delivery_period交割中 |