# 行情
### 描述
推送产品的最新成交价、买一价、卖一价和24小时交易量等行情数据；当行情发生变化（成交、买一价或卖一价更新）时，推送频率为 200ms。
```json title="请求示例"
{
"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` |
```json title="订阅返回示例"
{
"event": "subscribe",
"arg": {
"instType": "spot",
"topic": "ticker",
"symbol": "BTCUSDT"
},
"connId": "xxxxxxxxxx"
}
```
### 返回参数
| 返回字段 | 参数类型 | 字段说明 |
|:--------------|:-------|:----------------------------------------------------------------------------------------------------|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > instType | String | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`ticker`行情频道 |
| > symbol | String | 交易对名称 |
| code | String | 错误码 |
| msg | String | 错误消息 |
| connId | String | 连接ID |
```json title="推送返回示例"
{
"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",
"platformTurnover24h": "677732572.225658"
}
],
"arg": {
"instType": "spot",
"symbol": "BTCUSDT",
"topic": "ticker"
},
"action": "snapshot",
"ts": 1736371332162
}
```
### 推送数据参数
#### 现货推送
| 返回字段 | 参数类型 | 字段说明 |
|:-----------------|:-------------------|:------------------------|
| arg | Object | 订阅频道 |
| > instType | String | 产品线类型
`spot` 现货交易 |
| > topic | String | 频道名
`ticker`行情频道 |
| > symbol | String | 交易对名称 |
| action | String | 推送数据动作
`snapshot`全量 |
| data | List<Object> | 订阅的数据 |
| >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小时价格涨跌幅 |
| >platformTurnover24h | String | 24小时平台成交额
仅rtoken有值 |
#### 合约推送
| 返回字段 | 参数类型 | 字段说明 |
|:----------------------|:-------------------|:---------------------------------------------------------------------------------------------------------------------|
| arg | Object | 订阅成功频道 |
| > instType | String | 产品线类型
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`ticker`行情频道 |
| action | String | 推送数据动作
`snapshot`全量 |
| data | List<Object> | 订阅的数据 |
| >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`交割中 |