RPI订单介绍

RPI订单介绍

RPI（零售价格优化）订单是一种专为获批做市商提供的特殊订单类型，仅与 APP 及网页端的非算法订单撮合，为零售交易者提供更有针对性的市场流动性和更优的执行价格，同时保护做市商流动性挂单不被算法订单抢占，维护整体市场公平与诚信。

一、什么是 RPI 订单？

RPI 订单是仅供白名单做市商通过 OpenAPI 提交的特殊限价单，具备四大核心特点：

• 定向撮合：仅与 APP 及网页端提交的非算法订单成交，不与 API 订单（含其他 RPI 订单）或网格策略单撮合。
• 优先级最低：同一价位下，所有非 RPI 订单执行完毕后，RPI 订单才参与撮合。
• 只做 Maker：被动挂单，始终为订单簿提供流动性，不主动吃单。
• 可见性差异：APP 及网页端正常显示；API 公共订单簿中不可见。

二、谁可以提交？

仅获批白名单做市商可通过 OpenAPI 提交，且仅限白名单交易对。

• 非白名单做市商提交时提示：「RPI 订单仅适用于获批做市商」
• 非白名单币对提交时提示：「RPI 订单仅适用于特定交易对」

三、如何提交？

RPI 订单仅可通过 OpenAPI 提交，支持 REST 和 WebSocket 两种方式。下单时须将订单类型（type）设为限价单（buy-limit 或 sell-limit），并将 time-in-force 字段设为 rpi，其余参数与普通限价单一致。

REST 方式

现货、批量及杠杆三个下单接口均已支持 RPI 订单（type类型必须为buy-limit和sell-limit），在原有请求参数基础上新增 time-in-force 字段（值为 rpi）即可：

• 现货下单：POST /v1/order/orders/place
• 批量下单：POST /v1/order/batch-orders
• 杠杆下单：POST /v1/order/auto/place

请求示例（以现货 RPI 买单为例）：

{
  "account-id": "12345",
  "symbol": "btcusdt",
  "type": "buy-limit",
  "amount": "0.01",
  "price": "50000",
  "time-in-force": "rpi"
}

WebSocket 方式

WebSocket 交易频道同样支持 RPI 下单，参数与 REST 保持一致：

• 现货下单：频道 create-order
• 批量下单：频道 create-batchorder
• 杠杆下单：频道 create-margin-order

常见错误码

 

哪些币对支持 RPI 订单？

调用获取所有交易对接口 GET /v2/settings/common/symbol，返回数据中每个交易对包含 enable_rpi 字段（boolean）。值为 true 表示该交易对已开启 RPI 支持，值为 false表示不支持。

响应示例（仅展示关键字段）：

{
  "status": "ok",
  "data": [
    { "sc": "btcusdt", "dn": "BTC/USDT", "enable_rpi": true },
    { "sc": "ethusdt", "dn": "ETH/USDT", "enable_rpi": false }
  ]
}

如果向不支持 RPI 的交易对提交 RPI 下单请求，系统将返回错误码 order-rpi-symbol-not-allowed。

四、撮合范围

可与 RPI 撮合的订单

• 来源：APP 端 / 网页端
• 类型：市价单、限价单、高级限价-FOK、高级限价-IOC、止盈止损单、计划委托触发后的市价单/限价单
• 特殊：带单 / 跟单、冰山单均视同普通单，可正常撮合

不可与 RPI 撮合的订单

• 所有 API 订单（含其他 RPI 订单、API 渠道触发的计划委托）
• 网格策略单

五、交易规则

价格限制示例

• 提交价格 99 的 RPI 买单 → 接受
• 提交价格 102 的 RPI 买单 → 拒绝，因与卖二价102的普通单价格交叉

六、订单可见性

价格交叉隐藏示例：

示例1：两笔 RPI 订单价格交叉（买价 ≥ 卖价）→ 买卖两侧均隐藏

示例2：RPI 订单与 API 订单或网格单价格交叉 → 隐藏 RPI 订单，对手方正常显示

七、费率说明

RPI 订单适用专属 RPI Maker 费率，替代做市商原 Maker 费率；非 RPI 订单仍按原费率执行。

RPI 专属费率可通过接口 GET /v2/reference/transact-fee-rate 查询，返回参数中新增 rpiFeeRate 字段即为当前有效的 RPI Maker 费率；也可直接咨询 HTX 做市商运营团队。

 

 

八、API 端点和数据流更新

为支持 RPI 订单机制，现有接口按以下规则调整。

REST 市场数据

WebSocket 市场数据流

下单和查询订单接口（REST）

订单推送（WebSocket）

以上。