待发布内容

欧易将进行 USD 现货交易对迁移

最后更新：2026 年 9 月 11 日

OKX 将合并 USD 与 USDC 现货深度。作为本次调整的一部分，受影响的 Crypto-USD 现货产品将下线，用户需迁移至对应的 Crypto-USDC 产品。本次调整属于不兼容变更。更多详情，请根据所在地区参阅对应公告： USDⓢ 现货交易对迁移。

USDC 交易对开放及并行期

自 2026 年 9 月 23 日下午 4:00（UTC+8） 起，OKX 将开放相关 Crypto-USDC 现货产品。自开放起至 2026 年 9 月 30 日下午 4:00（UTC+8） 相关 Crypto-USD 现货产品下线前，部分 Crypto-USD 产品及其对应的 Crypto-USDC 产品将同时开放交易。

API 用户可在并行期内提前迁移至对应的 Crypto-USDC 产品 ID，适配 tradeQuoteCcy 的传参逻辑，并验证请求、返回及 WebSocket 订阅逻辑。

不兼容变更

• 当前请求中使用 Crypto-USD 产品 ID 的用户，需在变更上线后改用对应的 Crypto-USDC 产品 ID。在开始交易 Crypto-USDC 产品前，请先调用 POST /api/v5/account/activate-feature 接口开通 USDC 交易功能。已经在交易 USDC 产品的账户不受影响。
• 影响范围包括请求参数中包含 instId 或 instIdCode 的 REST API 和 WebSocket 频道，包括交易、订单查询、账户查询、策略交易、大宗交易、价差交易、行情请求及 WebSocket 订阅。
• Crypto-USD 产品 ID 不会映射为 Crypto-USDC 产品 ID。变更上线后，继续使用已下线的 Crypto-USD instId 或 instIdCode 发起请求或订阅，可能会失败或返回空数据。
• 返回参数将使用实际的 Crypto-USDC 产品 ID 或产品 ID Code。请在上线前更新请求构造、返回解析、订阅管理、产品缓存，以及所有依赖 instId 或 instIdCode 的业务逻辑。

重要：迁移下单时需正确传入 tradeQuoteCcy

tradeQuoteCcy 的默认值为 instId 中的计价币种。因此，如果仅将 instId 从 Crypto-USD 改为 Crypto-USDC，默认交易计价币种也会从 USD 变为 USDC。

如果您当前交易 Crypto-USD 产品时未传入 tradeQuoteCcy，迁移至对应的 Crypto-USDC 产品后仍希望使用 USD 交易，则必须显式传入 tradeQuoteCcy=USD。

下单前，请通过 获取交易产品基础信息（私有） 接口获取 tradeQuoteCcyList。传入的 tradeQuoteCcy 必须是当前产品及账户对应的 tradeQuoteCcyList 枚举值。

该迁移规则也适用于其他使用相关请求参数计算可交易数量或提交现货订单的接口，包括 获取最大可用余额/保证金、获取最大可下单数量 及 获取交易产品最大可借。

新增接口：开通 USDC 交易功能

在开始交易 Crypto-USDC 产品前，请先调用以下接口为账户开通 USDC 交易功能。已经在交易 USDC 产品的账户不受影响。

限速：5 次/2 秒

限速规则：User ID

HTTP 请求

POST /api/v5/account/activate-feature

请求示例

POST /api/v5/account/activate-feature
body
{
    "feature": "1"
}

请求参数

返回结果

{
    "code": "0",
    "msg": "",
    "data": []
}

返回参数

无

新增错误码

若账户尚未开通 USDC 交易功能，下单时将返回以下错误：

2026-09-15

RPI 挂单最小名义金额门槛

RPI 挂单（ordType: rpi 或 elp）现按产品类型使用不同的最小名义金额门槛。低于适用门槛的订单将被拒绝，返回错误码 54051。生产环境自 2026年9月15日 起生效。

各产品类型最低门槛

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

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

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 / 策略委托订单频道

2025-07-02

• 新增接口

  • 获取资金流水全历史

• 新增返回参数

  • 获取资金流水

2025-04-17

• 新增接口：

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

• 新增错误码

2025-03-03

提币API调整

由于合规要求，巴哈马主体用户在做 API 提币 时需要传入字段 rcvrInfo

用户提币到交易所钱包

当用户提币到交易所钱包，需要提供接交易所信息与收方信息。

• 交易所信息可以通过 获取交易所列表（公共） 接口查询。
• 用户需要传入接受方如下字段信息（rcvrFirstName,rcvrLastName,rcvrCountry,rcvrCountrySubDivision,rcvrTownName,rcvrStreetName）。对于交易所钱包接收方为公司的，rcvrFirstName可以填公司名称，rcvrLastName可以填"N/A"，地址信息可以填写公司注册地址。示例如下：

用户提币到私人钱包

当用户提币到私人钱包，需要提供接收方信息。

• 用户需要传入接受方如下字段信息（rcvrFirstName,rcvrLastName,rcvrCountry,rcvrCountrySubDivision,rcvrTownName,rcvrStreetName）。对于交易所钱包接收方为公司的，rcvrFirstName可以填公司名称，rcvrLastName可以填"N/A"，地址信息可以填写公司注册地址。示例如下：

2025-02-12

• 新增返回参数
  • 查看账户余额
  • 获取子账户交易账户余额
  • 账户频道

2024-11-14

• 调整返回参数
  • 获取币种列表

调整前

调整后

• 删除请求参数
  • 提币

• 新增接口
  • 获取子账户交易手续费费率

2024-10-10

• 新增返回参数
  • 获取币种列表

• 新增返回参数
  • 获取不可交易资产

• 价差交易支持市价单，ordType请求、返回参数新增枚举值market。

  • 下单
  • 获取订单信息
  • 获取未成交订单列表
  • 获取历史订单记录（近21天)
  • 获取历史订单记录（近三月)
  • WS / 下单
  • 订单频道

• 价差交易新增撤单场景，cancelSource返回参数新增枚举值15: 已撤单：该订单委托价不在限价范围内。

  • 获取订单信息
  • 获取未成交订单列表
  • 获取历史订单记录（近21天)
  • 获取历史订单记录（近三月)
  • 订单频道

2024-10-04

• 新增集合竞价信息 WebSocket 频道
  • WS / 集合竞价信息频道

2024-10-01

• 接口新增公共特性
  • GET / 公告

2024-09-19

• 新增返回参数
  • 查看账户配置

• 新增返回参数
  • 获取杠杆倍数

• 新增返回参数
  
  • 获取策略委托单信息
  • 获取未完成策略委托单列表
  • 获取历史策略委托单列表
  • 策略委托订单频道
  • 高级策略委托订单频道

2024-09-18

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