2026-08-20

WebSocket 订单频道推送行为调整

为了让客户能够更明确地判断 post-only（包括 mmp_and_post_only）与 rpi 新订单的最终状态，避免收到 state: live 后订单仍被撤销的场景，欧易已调整订单频道中 post-only 与 rpi 订单的 state: live 事件行为。

具体影响

• state: live 事件的推送时机由订单接收后立即推送，调整为订单成功进入订单簿之后才推送（延后约 1 ms）。
• 价格穿越 BBO 被撤单的挂单失败场景下，state: live 更新已被完全移除，只推送 state: canceled 更新。

生效时间

• 对于 rpi 订单（包括将要弃用的 elp 订单）：已上线 —— 模拟盘 —— 2026 年 7 月 23 日；实盘 —— 2026 年 7 月 28 日。
• 对于 post_only 和 mmp_and_post_only 订单：模拟盘 —— 2026 年 8 月 10 日（已上线）；实盘 —— 2026 年 8 月 20 日（已上线）。

影响范围

受影响的订单类型有：post_only、mmp_and_post_only、rpi（Retail Price Improvement）。

其他订单类型如 limit（普通限价单）、market（市价单）、ioc、fok 订单推送行为保持不变。

2026-08-18

RPI 挂单最小名义金额限制

RPI 挂单（ordType: rpi 或 elp）现需满足最小名义金额门槛。低于门槛的订单将被拒绝，返回错误码 54051。生产环境自 2026年8月18日 起生效。

各产品类型最低限额

本规则独立于各产品现有的最小下单量（minSz）校验——RPI 订单需同时满足两者。

下单

名义金额低于适用门槛的 RPI 订单将被拒绝，返回 54051。批量请求中每条子订单独立校验——未通过的子订单返回自身 sCode: 54051，其余子订单不受影响。

非 RPI 订单（包括 rpiTakerAccess: true 的 taker 订单）不受本规则影响。

改单

• 包含 newSz 的改单（无论是否同时修改 newPx）将按改后数量重新校验最小名义金额。若改后名义金额低于门槛，该次改单被拒绝，返回 54051；原订单继续有效。
• 仅修改 newPx（不含 newSz）的改单不重新校验本规则。

批量改单请求中每条子订单独立校验——行为与单笔改单一致。

存量订单

本规则生效前已在架的 RPI 挂单不受影响。校验仅适用于上线后新提交的下单与改单请求。

错误码

新增错误码：

适用于所有 REST 及 WebSocket trade 操作：

• POST / 下单
• POST / 批量下单
• POST / 修改订单
• POST / 批量修改订单
• WS / 下单
• WS / 批量下单
• WS / 改单
• WS / 批量改单

2026-08-11

RPI 挂单价格间距与可见性规则更新

RPI 挂单价格间距规则的交叉校验与价格档位校验现仅参考首个可见的对手方 RPI，不参考已隐藏的 RPI。RPI 的可见性同时决定 books-rpi 订单簿上展示的可成交 RPI 深度。本次不涉及任何接口、参数、枚举值或错误码的变更。

价格间距规则

• 交叉校验与价格档位校验仅参考首个可见的对手方 RPI，不参考已隐藏的 RPI
• 无可见对手方 RPI 时：交叉校验参考对手方有机最优买/卖价，价格档位校验通过
• bps 校验参考对手方有机最优买/卖价，不参考 RPI（不变）
• rpiPxRound 取整到首个可见对手方 RPI 之外的下一档，不参考已隐藏的 RPI

可见性

• 与对手方有机最优买/卖价交叉的 RPI 予以隐藏
• 在有机价差内相互交叉的买方 RPI 与卖方 RPI 双方均予以隐藏

改单

• 以改单命令到达撮合引擎时的订单簿快照进行校验
• 被改订单视为仍在订单簿中

影响 RPI 挂单的下单与改单（ordType: rpi），以及 books-rpi 订单簿：

• POST / 下单
• POST / 修改订单
• WS / 下单
• WS / 改单
• WS / 深度频道
• GET / 获取 RPI 产品深度

2026-08-06

获取历史市场数据接口最大查询范围下调

获取历史市场数据 接口的最大查询范围已由 20 下调至 10。

2026-07-28

ELP 更名为 RPI（散户价格优化）计划

OKX 将品牌 Enhanced Liquidity Program（ELP） 更名为 Retail Price Improvement（散户价格优化，RPI）。本次变更包含新的 RPI 合并深度订单簿（books-rpi，同时提供 WebSocket 与 REST）、更名后的挂单类型 rpi（替代 elp）、扩展后的下单参数 rpiTakerAccess（替代 isElpTakerAccess）、用于 RPI 挂单价格间距规则的新参数 rpiPxRound，以及更名后的账户字段 rpi/rpiMaker。

ELP 命名弃用截止日期：2026年10月31日

在此日期之前，OKX 将以两种不同方式并行运行 ELP 与 RPI 命名：

• 字段重命名——两者都被接受；当请求或响应中同时包含两者时，以 RPI 命名的字段为准：
  • isElpTakerAccess → rpiTakerAccess
  • elp → rpi
  • elpMaker → rpiMaker
• 取值重命名——互斥，只能二选一，不能同时传递：
  • ordType: elp → ordType: rpi
  • books-elp → books-rpi

现有集成可继续正常运行，无需改动。ELP 命名将于上述截止日期后停止支持——请在此之前完成所有集成向 RPI 命名的迁移。

新增合并深度：books-rpi（WS + REST）

• 新增 books-rpi，将非 RPI（有机）与 RPI 流动性合并为单一深度数据流——同时提供公共 WebSocket 频道（/ws/v5/public，400 档深度，初始全量推送 + 每 100 毫秒增量推送）与 REST 接口（GET /api/v5/market/books-rpi，服务端每 200 毫秒刷新一次）。不提供 checksum，WS 序列一致性依赖 seqId/prevSeqId。取代 books-elp（见上方迁移说明）。
  • WS / 深度频道
  • GET / 获取 RPI 产品深度

asks/bids 中的每个元素为 [price, totalQty, nonRpiQty, count]——totalQty 为该档位的总深度，nonRpiQty 为其中仅有机的部分，count 为该档位的汇总订单数量。

REST 请求参数：instId（必填）、sz（每侧深度档数，最大 400，默认 1）。

吃单参数：rpiTakerAccess（替代 isElpTakerAccess）

• rpiTakerAccess 是 isElpTakerAccess 的更名并扩展，支持所有标准订单类型（limit、market、fok、ioc；此前仅 ioc），并可在改单接口中设置。isElpTakerAccess 在弃用日期前将作为别名继续被接受（见上方迁移说明）。
• 错误码 54045（此前用于非 ioc 订单尝试吃取 RPI 流动性时返回）已废弃——现在 rpiTakerAccess 对所有订单类型均有效，该错误码不再可能触发。

均适用于下单/改单，REST + WS：

• POST / 下单
• POST / 批量下单
• POST / 修改订单
• POST / 批量修改订单
• WS / 下单
• WS / 批量下单
• WS / 改单
• WS / 批量改单

挂单类型：rpi（替代 elp）

• 下 RPI 挂单时，请将 ordType 设为 rpi 而非 elp。elp 在弃用日期前将继续被接受（见上方迁移说明）——ordType 只能取一个值，二者选其一，不能同时传递。

适用于下单，REST + WS：

• POST / 下单
• POST / 批量下单
• WS / 下单
• WS / 批量下单

挂单参数：rpiPxRound

• rpiPxRound 为新增参数，用于 RPI 挂单价格间距规则（详见下文）。仅对 RPI 挂单（ordType: rpi）生效；对非 RPI 订单及 OPTION/EVENTS 将被忽略。

均适用于下单/改单，REST + WS（接口列表同上方 rpiTakerAccess）。

• 在 orders WebSocket 私有频道新增 amendSource 枚举值 6：表示系统为满足 RPI 挂单价格间距规则（由 rpiPxRound 触发）而自动调整（取整）了订单价格。
  • WS / 订单频道

RPI 挂单价格间距规则

RPI 挂单需遵守间距规则（见下方 rpiMinLevel / rpiMinPxBand）。订单违反该规则时将被拒绝，除非 rpiPxRound 设为 true，此时价格会自动向外取整至最近的合规价位（见上方 rpiPxRound）。

• 新增返回参数 rpiMinLevel 与 rpiMinPxBand，用于展示各产品的间距阈值。
  • 获取交易产品基础信息（公共）

RPI 挂单权限字段：rpi（替代 elp）

• 新增返回参数 rpi，用于表示 RPI 挂单权限。elp 在弃用日期前将作为别名继续被接受（见上方迁移说明）。
  • 获取交易产品基础信息（私有）

RPI 挂单费率字段：rpiMaker（替代 elpMaker）

• 新增返回参数 rpiMaker，用于表示 RPI 挂单有效费率。elpMaker 在弃用日期前将作为别名继续被接受（见上方迁移说明）。
  • 获取当前账户交易手续费费率

成交来源字段：source

• GET /api/v5/market/trades 返回字段 source 取值 1 的说明由"流动性增强计划订单"更新为 RPI 订单（原 ELP 订单）。返回的取值 1 本身不变，仅更新说明文字。
  • GET / 获取交易产品公共成交数据

错误码变更

错误消息由 ELP 更新为 RPI：

已弃用错误码：

2026-07-23

GLP 做市商表现 API

新增两个只读接口，面向已加入 Global Liquidity Program (GLP) 的做市商查询自己的考核表现：当日快照（含当日及 MTD）和逐日历史记录。仅已加入且在有效期的 GLP 做市商可调用，子账户解析到其 master account。

• 以下为新增接口：
  • GET / 获取 GLP 当日表现
  • GET / 获取 GLP 历史表现

GET / 获取 GLP 当日表现

获取当前账户在所有已加入 GLP 业务线（Spot / Perp / Expiry & Nitro）的当日和月度累计（MTD）表现快照。无需请求参数，账户由 API key 自动解析。

限速：5次/2s

限速规则：User ID

权限：读取

HTTP请求

GET /api/v5/users/glp/todayperformance

请求示例

GET /api/v5/users/glp/todayperformance

请求参数

无。账户由登录态自动解析。

返回示例

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "dataReady": true,
            "dataDate": "2026-07-13",
            "account": {
                "masterAccountId": "832545488879789797",
                "combinedAccountIds": ["832545488879789798"]
            },
            "programs": [
                {
                    "program": "SPOT",
                    "marketMakerBusinessId": "1",
                    "enrollmentStatus": "ENROLLED",
                    "marketMakerLevelId": "42",
                    "enrolledTierDisplay": "Tier 1 Class A",
                    "qualifyingPool": "TYPE_A",
                    "qualifyingRows": ["TOTAL"],
                    "daily": {
                        "volume": {
                            "typeA": {"maker": "1000000.00", "taker": "1000000.00"},
                            "typeBTotal": {"maker": "1000000.00", "taker": "1000000.00"},
                            "tradfiX2": {"maker": "1000000.00", "taker": "1000000.00"},
                            "total": {"maker": "2000000.00", "taker": "2000000.00"}
                        },
                        "share": {
                            "typeA": {"maker": "0.0000", "taker": "0.0000"},
                            "typeBAdj": {"maker": "0.0000", "taker": "0.0000"},
                            "total": {"maker": "0.0000", "taker": "0.0000"}
                        }
                    },
                    "mtd": {
                        "volume": {
                            "typeA": {"maker": "30000000.00", "taker": "30000000.00"},
                            "typeBTotal": {"maker": "30000000.00", "taker": "30000000.00"},
                            "tradfiX2": {"maker": "30000000.00", "taker": "30000000.00"},
                            "total": {"maker": "60000000.00", "taker": "60000000.00"}
                        },
                        "share": {
                            "typeA": {"maker": "0.0000", "taker": "0.0000"},
                            "typeBAdj": {"maker": "0.0000", "taker": "0.0000"},
                            "total": {"maker": "0.0000", "taker": "0.0000"}
                        },
                        "mtdStatus": "QUALIFIED",
                        "qualifyingShare": {"maker": "0.0000", "taker": "0.0000"}
                    }
                }
            ]
        }
    ]
}

返回参数

交易量和份额结构

daily 和 mtd 均包含 volume（交易量）和 share（份额）两个 Object。每个 Object 下含分类 key，每个分类为包含 maker（String）和 taker（String）字段的 Object。

• volume 值：美元名义量，String，保留 2 位小数（如 "1000000.00"）
• share 值：小数字符串，4 位小数，无 % 后缀（如 "0.0000"）

GET / 获取 GLP 历史表现

获取单个 GLP 业务线的逐日表现记录，按日期降序排列（最新日期在前）。

限速：5次/2s

限速规则：User ID

权限：读取

HTTP请求

GET /api/v5/users/glp/historicalperformance

请求示例

GET /api/v5/users/glp/historicalperformance?program=SPOT
GET /api/v5/users/glp/historicalperformance?program=SPOT&begin=1751299200000&end=1753804800000&limit=31

请求参数

返回示例

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "date": "2026-07-13",
            "volume": {
                "typeA": {"maker": "1000000.00", "taker": "1000000.00"},
                "typeBTotal": {"maker": "1000000.00", "taker": "1000000.00"},
                "tradfiX2": {"maker": "1000000.00", "taker": "1000000.00"},
                "total": {"maker": "2000000.00", "taker": "2000000.00"}
            },
            "share": {
                "typeA": {"maker": "0.0012", "taker": "0.0010"},
                "typeBAdj": {"maker": "0.0008", "taker": "0.0007"},
                "total": {"maker": "0.0010", "taker": "0.0009"}
            }
        },
        {
            "date": "2026-07-12",
            "volume": {
                "typeA": {"maker": "950000.00", "taker": "980000.00"},
                "typeBTotal": {"maker": "850000.00", "taker": "900000.00"},
                "tradfiX2": {"maker": "800000.00", "taker": "820000.00"},
                "total": {"maker": "1800000.00", "taker": "1880000.00"}
            },
            "share": {
                "typeA": {"maker": "0.0011", "taker": "0.0009"},
                "typeBAdj": {"maker": "0.0007", "taker": "0.0006"},
                "total": {"maker": "0.0009", "taker": "0.0008"}
            }
        }
    ]
}

返回参数

错误码

FUTURES 和 SWAP 计划委托支持追逐限价委托（Chase Order）

FUTURES 和 SWAP 计划委托（Trigger Order）现可在触发时下发追逐限价委托（Chase Order）——advanceOrdType 新增取值 chase，其参数由新增数组 advChaseParams 承载。查询接口通过新增字段 subAlgoIdList 返回触发后生成的追逐委托 algoId；在计划委托触发前，可通过改单接口修改追逐值。本期暂不支持追逐委托与附带止盈止损（attachAlgoOrds）同时设置。

策略委托下单

• advanceOrdType 新增取值 chase，并新增 advChaseParams 数组；orderPx 变更为条件必填（追逐委托不适用）。
  • POST / 策略委托下单

修改策略委托订单

• 新增 advChaseParams 改单字段，用于在计划委托挂单期间（触发前）调整追逐值。chaseType、maxChaseType 及追逐价格模式在下单时固定，不可修改。
  • POST / 修改策略委托订单

查询接口（委托单信息、委托单列表、WS 频道）

• 新增返回参数 advanceOrdType（含新取值 chase）、advChaseParams，以及新增的 subAlgoIdList。
  • GET / 获取策略委托单信息
  • GET / 获取未完成策略委托单列表
  • GET / 获取历史策略委托单列表
  • WS / 策略委托订单频道

2026-05-26

• 新增错误码

2025-07-02

• 新增接口

  • 获取资金流水全历史

• 新增返回参数

  • 获取资金流水

2025-06-26

• 特定国家和地区支持交易交割和永续合约

2025-06-24

• 新增接口
  • 提币

2025-05-28

• 新增接口，以下账单流水（自 2021 年）接口已上线实盘
  • 申请账单流水（自 2021 年）
  • 获取账单流水（自 2021 年）

2025-04-17

• 新增接口：

  • 创建子账户
    
  • 创建子账户的APIKey
    
  • 查询子账户的APIKey
    
  • 删除子账户的APIKey
    

• 新增错误码

2024-09-18

• 新增接口
  • GET / 公告
  • GET / 公告类型