# RPI深度
### 描述
获取[RPI（零售价格优化）](https://www.bitget.com/zh-CN/support/articles/12560603867770#:~:text=RPI)深度数据，`rpi-books`是全量深度频道，`rpi-books1`是1档频道，`rpi-books5`是5档频道，`rpi-books50`是50档频道；
- `rpi-books` 对应全量深度数据，首次推送全量数据 `snapshot`，后续推送增量变化数据: `update`
- `rpi-books1` 对应1档位深度数据，每次推送: `snapshot`
- `rpi-books5` 对应5档位深度数据，每次推送: `snapshot`
- `rpi-books50` 对应50档位深度数据，每次推送: `snapshot`
- `rpi-books1` 推送频率:10ms
- `rpi-books5` 推送频率:100ms
- `rpi-books50` 推送频率:100ms
- `rpi-books` 推送频率:100ms
**seq机制**
- 普通orderbook 及RPI orderbook的seq为两套独立规则，均单独计算
```json title="请求示例"
{
"op": "subscribe",
"args": [
{
"instType": "usdt-futures",
"topic": "rpi-books5",
"symbol": "BTCUSDT"
}
]
}
```
### 请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|:--------------|:-------------------|:-----|:----------------------------------------------------------------------------------------------------|
| op | String | 是 | 操作
`subscribe` 订阅
`unsubscribe` 退订 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 是 | 频道名
`rpi-books`全部档位频道
`rpi-books1`一档频道
`rpi-books5`五档频道
`rpi-books50`五十档频道 |
| > [symbol](/zh-CN/docs/catalog/market/market-data#get-instruments) | String | 是 | 交易对名称
例如`BTCUSDT` |
```json title="订阅返回示例"
{
"event": "subscribe",
"arg": {
"instType": "usdt-futures",
"topic": "rpi-books5",
"symbol": "BTCUSDT"
},
"connId": "xxxxxxxxxx"
}
```
### 返回参数
| 返回字段 | 参数类型 | 字段说明 |
|:--------------|:-------|:----------------------------------------------------------------------------------------------------|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > instType | String | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名 |
| > symbol | String | 交易对名称 |
| code | String | 错误码 |
| msg | String | 错误消息 |
| connId | String | 连接ID |
```json title="推送返回示例"
{
"data": [
{
"a": [
[
"3366.8",
"9",
"1"
],
[
"3367",
"0",
"1"
],
[
"3368",
"8",
"2"
]
],
"b": [
[
"3366.1",
"7",
"1"
],
[
"3366",
"6",
"1"
]
],
"pseq": 0,
"seq": 1304314508780744705,
"ts": "1730969017964"
}
],
"arg": {
"instType": "usdt-futures",
"symbol": "BTCUSDT",
"topic": "rpi-books5"
},
"action": "snapshot",
"ts": 1730969017965
}
```
### 推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|:-------------------|:-------------------|:----------------------------------------------------------------------------------------------------|
| arg | Object | 订阅成功的频道 |
| > instType | String | 产品线类型
`spot` 现货交易
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名 |
| > symbol | String | 交易对名称 |
| action | String | 推送数据动作
`snapshot`全量
`update` 增量 |
| ts | String | 数据推送时间戳 |
| data | List<Object> | 订阅的数据 |
| > a | List<String> | 卖方深度 |
| > > a[0] | String | 卖方价格 |
| > > a[1] | String | 卖方非RPI数量 |
| > > a[2] | String | 卖方RPI数量 |
| > b | List<String> | 买方深度 |
| > > b[0] | String | 买方价格 |
| > > b[1] | String | 买方非RPI数量 |
| > > b[2] | String | 买方RPI数量 |
| > > seq | String | 序列号
订单簿更新时递增，可以用来判断是否乱序 |
| > > pseq | String | 上次推送序列号，可以用来判断是否丢包，只有rpi-books频道有值 |
| > > ts | String | 撮合时间戳 |