导航
English
Java Python Go C++

待发布内容

2026-09-30

交易产品频道推送优化

欧易已优化交易产品频道的推送方式。

在部分场景中，该频道现已由全量推送改为增量推送，仅推送数据发生变化的产品。

未来可能会有更多场景由全量推送改为增量推送，届时不再另行通知。客户端收到推送后，应根据 instId 更新本地产品缓存，不应假设每次推送均包含全量产品数据。

USD 现货交易对迁移

欧易已合并 USD 与 USDC 现货深度。受影响的 Crypto-USD 现货产品已下线，API 用户须使用对应的 Crypto-USDC 产品。

迁移要求

交易计价币种

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

迁移至对应的 Crypto-USDC 产品后，如需继续使用 USD 交易，请显式传入 tradeQuoteCcy=USD。

场景 迁移前 迁移后
继续使用 USD 交易 "instId": "Crypto-USD"
未传 tradeQuoteCcy		 "instId": "Crypto-USDC"
"tradeQuoteCcy": "USD"
使用 USDC 交易 "instId": "Crypto-USD"
"tradeQuoteCcy": "USDC"		 "instId": "Crypto-USDC"
"tradeQuoteCcy": "USDC" 或不传 tradeQuoteCcy

下单前，请通过 GET / 获取交易产品基础信息 获取支持的 tradeQuoteCcyList。

2026-09-15

RPI 挂单最小名义金额门槛

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

各产品类型最低门槛

产品类型 最小名义金额
SPOT 500 USD
FUTURES 2,000 USD
SWAP 5,000 USD

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

2026-08-20

WebSocket 订单频道推送行为调整

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

具体影响

场景 调整前 调整后
post-only 订单挂单失败
（价格穿越 BBO 被撤单）		 state: live → state: canceled 只推 state: canceled（不再有 state: live）
post-only 订单成功挂单 立即推 state: live state: live（延后约 1 ms）
post-only 订单成功挂单后被吃单
（一次成交）		 state: live → state: filled state: live（延后约 1 ms） → state: filled
post-only 订单成功挂单后被吃单
（多次部分成交）		 state: live → state: partially_filled → state: filled state: live（延后约 1 ms） → state: partially_filled → state: filled
post-only 订单带 reduceOnly: true，
size 被修改		 state: live → state: live（amendSource: 4，amendResult: 0） state: live（amendSource: 4，amendResult: 0） → state: live
rpi 订单，rpiPxRound: false，
挂单失败
（不满足价格间距规则被撤单）		 N/A 只推 state: canceled（不会有 state: live）
rpi 订单，rpiPxRound: true，
并且 price 被修改		 N/A state: live（amendSource: 6，amendResult: 0） → state: live

生效时间

影响范围

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

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

2026-08-20

EEA 节点（Affiliate）API 文档说明更新

EEA 站的节点（Affiliate）API 文档已更新，以明确 CPS 和 TVB 激励模式下的数据范围和指标定义。

激励模式和数据范围

指标定义

TVB 接口说明

2026-08-18

RPI 挂单最小名义金额限制

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

各产品类型最低限额

产品类型 最小名义金额
SWAP / FUTURES 10,000 USD
SPOT 1,000 USD
EVENTS 不适用

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

下单

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

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

改单

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

存量订单

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

错误码

新增错误码：

错误码 消息
54051 RPI 订单被拒绝。订单价值低于 RPI 订单所需的最低金额（{param0} USD）。

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

2026-08-14

节点（Affiliate）REST API 对齐 EEA 节点返佣方案

EEA 站的节点（Affiliate）接口已根据 EEA 节点返佣方案进行更新。

下线接口

结算币种变更

区域返佣资格

2026-08-11

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

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

价格间距规则

可见性

改单

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

2026-08-06

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

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

参数名 类型 描述
begin String 最大范围：日度 10 天，月度 10 个月（此前为 20 天 / 20 个月）。

2026-08-03

联盟受邀用户接口新增 UID、加入时间筛选与滚动窗口成交量

参数名 类型 是否必须 描述
uid String 否 按外部 UID 精确匹配。单个或最多 100 个 UID，以逗号分隔。无法解析的 UID 静默跳过；若全部无法解析，返回空页。
joinTimeBegin String 条件必填 按 joinTime 过滤的下界，Unix时间戳的毫秒数格式，包含端点。需与 joinTimeEnd 同时传入；区间不超过 90 天，且不早于当前时间 180 天前。
joinTimeEnd String 条件必填 按 joinTime 过滤的上界，Unix时间戳的毫秒数格式，包含端点。需与 joinTimeBegin 同时传入。
参数名 类型 描述
periodType（请求） String volPeriod 的统计窗口：last_7d、last_30d、this_month、last_month、total、today、this_week。不传时不返回 volPeriod。
volPeriod（响应） String 所选 periodType 窗口内的交易量，单位为 USDT。仅当传入 periodType 时返回。窗口内无交易时返回 0。

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 命名：

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

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

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

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

吃单参数：rpiTakerAccess（替代 isElpTakerAccess）

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

参数名 类型 是否必须 描述
rpiTakerAccess Boolean 否 默认值为 false。
设为 true 时，订单可使用 RPI 流动性，适用于所有标准订单类型（此前仅 ioc）。
当 rpiTakerAccess 为 true 时，减速带机制在下单和改单时均适用于所有 ordType，包括 post_only。
改单时不会从原始订单继承，必须每次显式指定（省略则该次改单视为 false）。

挂单类型：rpi（替代 elp）

适用于下单，REST + WS：

挂单参数：rpiPxRound

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

参数名 类型 是否必须 描述
rpiPxRound Boolean 否 默认值为 false。设为 true 时，违反间距规则的价格将自动向外取整至最近的可挂单、且不会吃单的价位，而非直接拒绝。

RPI 挂单价格间距规则

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

参数名 类型 描述
rpiMinLevel String RPI 买一价与卖一价之间的最小间距，以有机价格档位数计。默认值为 4；事件合约（Event Contracts）为 0。
rpiMinPxBand String 满足间距规则所需的、与对方最优有机报价之间的最小距离，单位为基点（bps），例如 20。

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

参数名 类型 描述
rpi String RPI 挂单权限。
0：该产品未开通 RPI
1：已开通，但当前用户无权限下 RPI 订单
2：已开通且当前用户有权限
返回 1/2 不代表当前存在 RPI 流动性。

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

参数名 类型 描述
rpiMaker String RPI 挂单有效费率，若该产品不适用 RPI 则返回 ""。

成交来源字段：source

错误码变更

错误消息由 ELP 更新为 RPI：

错误码 原消息 更新后消息
54039 ELP 订单不支持仅减仓设置 RPI 订单不支持仅减仓设置
54040 ELP 订单无法与止盈止损设置同时使用 RPI 订单无法与止盈止损设置同时使用
54041 {param0} 不支持下 ELP 订单 {param0} 不支持下 RPI 订单
54042 您无法为 {param0} 下 ELP 订单 您无法为 {param0} 下 RPI 订单
54043 您最多只能为 {param0} 下 {param1} 个 ELP 订单，请撤销部分订单后再试 您最多只能为 {param0} 下 {param1} 个 RPI 订单，请撤销部分订单后再试
54044 {param0} 不支持 ELP，你不能吃单 ELP 挂单 {param0} 不支持 RPI，你不能吃单 RPI 挂单
54046 你不能吃单 ELP 挂单 你不能吃单 RPI 挂单
54049 由于系统繁忙，API 用户目前无法吃单 ELP 挂单。请将 isElpTakerAccess 设置为 false 以继续操作 由于系统繁忙，API 用户目前无法吃单 RPI 挂单。请将 rpiTakerAccess 设置为 false 以继续操作

已弃用错误码：

错误码 消息 原因
54045 OpenAPI 用户只能下 IOC 订单来吃单 ELP 挂单 已废弃——rpiTakerAccess 现适用于所有订单类型，不再限于 IOC。

2026-07-27

TVB（交易量返佣）节点分档、被邀请人及链接接口

在 /api/v5/affiliate/tvb/* 下新增四个节点（Affiliate）REST API 接口，将交易量返佣（Trading Volume Bonus，TVB）报表从聚合业绩概览进一步扩展——分档返佣明细、分页被邀请人列表、单个被邀请人详情查询，以及分链接业绩列表。所有金额均以 USDC 结算。

新增接口

2026-07-20

TVB（交易量返佣）节点业绩接口

在 /api/v5/affiliate/tvb/* 下新增一个节点（Affiliate）REST API 接口，用于查询交易量返佣（Trading Volume Bonus，TVB）业绩——按可选统计窗口返回累计返佣、有效及符合条件的交易量、有效/符合条件的交易者与被邀请人数、入金额、首次交易者/首次入金者数量，以及节点返佣倍率。返佣以 USDC 结算。

新增接口

2026-07-06

节点（Affiliate）接口扩展

以下节点（Affiliate）接口此前已在全局站上线，现已同步开放至 EEA 站。此外，获取被邀请人返佣信息接口新增两个返回参数，并调整了限速。

新增接口

新增返回参数

参数名 类型 描述
wdAmt String 累计提现金额，单位为 USDT。如果没有提现，返回 0。
totalVol String 生命周期累计交易量，单位为 USDT。如果没有交易，返回 0。

限速变更

2026-05-26

错误码 HTTP状态码 错误提示
54092 200 操作要求：请通过网页端或 App 前端尝试下单 TradFi 永续合约（TradFi Perps）交易，并完成免责声明确认。每个主账户及子账户都必须单独接受免责声明后，方可启用 API 交易功能。

2025-12-15

2025-07-02

更新前

参数名 类型 是否必须 描述
after String 否 查询在此之前的内容，值为时间戳，Unix 时间戳为毫秒数格式，如 1597026383085
before String 否 查询在此之后的内容，值为时间戳，Unix 时间戳为毫秒数格式，如 1597026383085

更新后

参数名 类型 是否必须 描述
after String 否 查询在此之前的内容，值为时间戳或账单记录ID，Unix 时间戳为毫秒数格式，如 1597026383085
before String 否 查询在此之后的内容，值为时间戳或账单记录ID，Unix 时间戳为毫秒数格式，如 1597026383085
pagingType String 否 分页类型
1：按账单记录时间戳分页
2：按账单记录ID分页
默认值为1
参数 类型 描述
notes String 备注

2025-05-28

2025-04-17

错误码 错误提示
59515 您当前不在托管账户白名单上。请联系客服寻求帮助。
59516 请先创建 Copper 托管资金账户
59517 请先创建 Komainu 托管资金账户
59518 您当前无法使用 API 创建子账户。请在网页端或 App 端创建。
59519 此功能已冻结，暂时无法使用，冻结原因：{freezereason}

2025-02-12

参数名 类型 描述
notionalUsdForBorrow String 借币金额（美元价值）
适用于现货模式/跨币种保证金模式/组合保证金模式
notionalUsdForSwap String 永续合约持仓美元价值
适用于跨币种保证金模式/组合保证金模式
notionalUsdForFutures String 交割合约持仓美元价值
适用于跨币种保证金模式/组合保证金模式
notionalUsdForOption String 期权持仓美元价值
适用于现货模式/跨币种保证金模式/组合保证金模式

2025-01-14

欧洲经济区主体用户提币API调整

由于合规要求，欧洲经济区主体用户在做 API 链上提币/闪电网络提币 时需要传入字段 rcvrInfo

参数名 类型 是否必须 描述
rcvrInfo Object 可选 接收方信息
特定 国家/地区 认证用户做链上提币/闪电网络提币 需要提供此信息
> walletType String 是 钱包类型
exchange：提币到交易所钱包
如果提币到交易所钱包，必须提供接收方相关信息。
对于交易所钱包接收方为公司的，rcvrFirstName可以填公司名称，rcvrLastName可以填"N/A"。
> exchId String 可选 交易所 ID
可以通过 获取交易所列表（公共） 接口查询支持的交易所
如果交易所不在支持的交易所列表中，该字段填0
> rcvrFirstName String 可选 接收方名字，如 Bruce
> rcvrLastName String 可选 接收方姓氏，如 Wayne

用户提币到交易所钱包

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

用户提币到私人钱包

不支持 API 提币至私人钱包。请通过欧易 App 或官网完成提币操作。

其他接口调整

参数名 类型 描述
note String 备注信息
参数名 类型 描述
state String 17：钱包地址正等待国际转账规则认证

新增错误码

错误码 错误提示
58239 不支持 API 提币至私人钱包。请通过欧易 App 或官网完成提币操作。

2024-12-30

2024-09-19

参数名 类型 描述
enableSpotBorrow Boolean 现货模式是否支持借币
true：支持
false：不支持
spotBorrowAutoRepay Boolean 现货模式是否支持自动还币
true：支持
false：不支持
参数名 类型 描述
ccy String 币种
参数名 类型 描述
isTradeBorrowMode String 是否自动借币
true：自动借币
false：不自动借币
仅适用于计划委托、移动止盈止损和 时间加权策略

2024-09-18

Java Python Go C++