2、涉及的接口：restAPI
 a.单个币种合约账户信息 GET /api/futures/v3/accounts/
 b.账单流水查询 GET /api/futures/v3/accounts//ledger c.设定合约杠杆倍数（全仓） POST /api/futures/v3/accounts//leverage d.获取合约币种杠杆倍数 GET /api/futures/v3/accounts//leverage e.公共获取合约信息 GET /api/futures/v3/instruments - - - -返回值增加必要字段 f.设置合约账户模式 POST /api/futures/v3/accounts/margin_mode - - - -此接口不做兼容 g.获取所有币种合约账户信息 GET /api/futures/v3/accounts - - - -返回值增加必要字段 3、涉及的接口: WebsocketAPI a.公共-全量合约信息频道 futures/instruments - - - - 返回值增加必要字段 b.个人-订阅账户信息频道 futures/account

目标价 / 行权价 Daily Up/Down 每日价格涨跌 合约： 目标价为参考时间（5:00:00 PM ET）的 XAU-USDT 指数开盘价，或具体合约条款中列明的其他目标价。 Daily Above 每日价格高于 合约： 行权价（阈值价）为合约上线时展示的阈值价格。3. 交易时段与预定非交易日 黄金底层 TradFi 市场存在固定交易时段与节假日休市安排。OKX 参考 XCEC Holiday Calendar ，识别 XAU 指数底层 TradFi 组成部分的预定非交易日。 XCEC 已知非交易日（包含美国法定假日）为非交易日。若 XAU 事件合约的预定到期日落在非交易日，OKX 将不予上线该事件合约，该类事件在上线环节即被排除。4. 市场异常与交易中断处理（Market Disruption & Trading Halt） 事件合约上线后，若底层 TradFi 市场发生交易中断、休市或其他价格异常，OKX 将根据下列情形分类处理。除情形 A（上线层排除）外，所有情形均经复议程序确定最终结算价。4.1 触发情形与结算价确定方式 情形 触发条件 结算价确定方式 A.

附录 A. 案例1：带有AlertCondition() + Alert手动设置的MACD脚本 要创建一个警报，需要定义触发它的条件。这个条件可以基于各种因素，如价格、指标或自定义逻辑。以下派语言使用MACD技术指标作为示例。

受影响的 Open API 接口有： 接口名称 接口路径 获取订单信息 GET /api/v5/trade/order (仅影响已成交和已撤销的订单) 获取成交明细 (近三天) GET /api/v5/trade/fills 获取成交明细 (近三个月) GET /api/v5/trade/fills-history 账单流水查询 (近七天) GET /api/v5/account/bills 账单流水查询 (近三月) GET /api/v5/account/bills-archive 获取历史订单记录 (近七天) GET /api/v5/trade/orders-history 获取历史订单记录 (近三个月) GET /api/v5/trade/orders-history-archive 获取历史策略委托单列表 GET /api/v5/trade/orders-algo-history (仅影响止盈止损订单) 查看历史持仓信息 GET /api/v5/account/positions-history WebSocket 推送服务不受影响，维护期间仍然可以正常使用。

改造内容如下（此公告仅涉及到API交易用户，V1 OpenAPI不支持USDT保证金合约交易）： 
1、涉及的接口： a.公共-获取合约信息 GET /api/swap/v3/instruments - - - -返回值增加必要字段 
API接口改造后，您的程序不会受影响。但是在接口中会有新的字段增加。给您带来的不便，敬请谅解！ 
V3 API相较V1更稳定、效率更高、功能更全，且V1 Restful API 也将按照计划逐步停止服务，建议用户优先使用V3 API 。如API使用过程中有任何问题或有任何API产品需求，欢迎添加WX：ApiSupport，备注：API+姓名+ok账号，我们将提供专业高效的技术支持服务。 欧易OKX将持续不断为您提供更优秀的产品和更优质的服务！ 
 欧易OKX
 2019年11月25日
 加入欧易OKX社群
 Twitter：https://twitter.com/OKX
 Telegram：https://t.me/OKXGroup_Chinese

十五、接口报错：51121 Order quantity must be a mult IP le of the lot size. 在 API 中合约下单是以张为单位的，必须是该币对最小下单数量的倍数，最小下单数量可以通过产品接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments 的minSz 字段获取。十六、提币报错：58207 Withdrawal address is not whitelisted for verification exemption；在提币页面关闭了白名单校验为什么还是会报错呢？ 使用 API 接口提币是必须要在页面添加提币地址并勾选免验证按钮的，页面是否关闭白名单校验并不会影响接口功能。

尊敬的欧易用户： 今天发生了一些与REST API接口相关的问题，包括GET/api/v5/account/balance和GET/api/v5/account/positions。这些问题已经解决，欧易将会及时发布一份事故报告。 对于这次事件可能造成的任何不便，我们深表歉意。 欧易团队

风险准备金的当前价值低于： (a) 过去 8 小时内适用风险准备金的平均价值（“8 小时平均值”）减去以下两项中的较大者： (i) 8 小时平均值的 30%；或 (ii) 50,000 美元（或等值金额） （(a) 的结果为“波动跌幅阈值”）； 2. 风险准备金全部亏损完毕时； 3. 只适用于数字资产盘前交易合约：未成交的强平单超过了一定的数量和时间阈值（由OKX确定），并且市场无法有效吸收这些订单。存在大量市场无法有效吸收的未成交的强平单。 以波动跌幅阈值触发条件为例，假设： A. 适用风险准备金的当前价值为 200,000 美元； B. 8 小时平均值为 400,000 美元； C. 8 小时平均值的 30% 为 120,000 美元（由于该金额大于 50,000 美元，因此将适用上述1(a)(i) 触发条件，而不是1(a)(ii) 触发条件）。 之后，由于 200,000 美元小于波动跌幅阈值 280,000 美元（即 400,000 美元 - 120,000 美元），因此将触发 ADL。 ADL的关停条件 ： 1. 准备金恢复到峰值的75%以上； 2.

3.API调整内容： 1）Restful：公共-获取合约下一次结算时间接口（GET/api/swap/v3/instruments//funding_time） 增加参数： estimated_rate（下一期的预测资金费率，String） funding_rate （当期资金费率，String） 2）Websocket：公共-资金费率频道（swap/funding_rate） 增加参数： estimated_rate（下一期的预测资金费率，String） 3）v3 现使用参数：funding_rate 取值由目前“资金费率”变为“当期资金费率” 4.每分钟的资金费率计算公式为： 资金费率=Clamp(MA((（合约买一价+合约卖一价）／2-现货指数价格)／现货指数价格 - Interest), a, b) *Interest当前为0 *BTC、ETH、EOS、XRP、BCH、BSV、ETC、LTC、TRX永续合约：a=-0.3%,b=0.3% 资金费率公式及其他资金费用的相关规则不受影响，附：线上资金费用规则说明。

具体详情如下：一、SOL 事件合约新品种上架 上架时间： 2026 年 5 月 14 日 16:00（UTC+8）后 欧易事件合约将新增以下 SOL 相关事件品种： SOL 涨跌（Up/Down）事件 SOL 价格高于（Price Above）事件二、5 分钟涨跌事件即将推出 预计上线时间： 2026 年 5 月 19 日 欧易事件合约即将推出全新的 5 分钟涨跌（5-Min Up/Down） 事件品种，首批支持 BTC、ETH、SOL，敬请期待。三、结算规则更新 生效时间： 到期时间晚于 2026 年 5 月 14 日 16:00（UTC+8）的事件按新规则结算；到期时间在此之前的事件继续按现行规则结算。本次共涉及 2 项结算规则调整： # 项目 现行规则 调整后 1 结算取值 结算窗口内秒级指数 K 线 开盘价（open） 的算术平均 结算窗口内秒级指数 K 线 收盘价（close） 的算术平均 2 15 分钟涨跌事件 — 结算窗口 60 秒（60 个数据点） 15 秒（15 个数据点） 其他结算机制（指数源 = OKX 现货指数、结果判定、复议流程）保持不变。

具体详情如下：一、上线品种 品种 说明 XAU Daily Up/Down（日度涨跌） 预测结算价相对目标价的涨跌方向 XAU Daily Price Above（日度价格高于） 预测结算价是否达到或超过指定阈值价格二、结算规则 结算指数： OKX XAU-USDT 指数结算时间： 美国东部时间（ET）下午 5:00:00，自动随美东夏令时（EST/EDT）切换调整，对应时区换算如下： 时区 冬令时（EST）期间 夏令时（EDT）期间 UTC+8（北京/香港） 次日 06:00 次日 05:00 UTC 22:00 21:00 结算价格： 结算时间前 60 秒内 XAU-USDT 指数价格的算术平均值，精度为 4 位小数（四舍五入）。三、交易时段与非交易日 目前 XAU 事件合约的结算时间与国际现货黄金市场（CME COMEX）交易时段挂钩。 非交易日处理： OKX 参考 XCEC 假日日历及相关交易时段数据，若事件合约的预定到期时间落在已知非交易日，将不予上线该时段的事件合约。

用户可以通过 Open API 接口 GET /api/v5/account/instruments 或 WebSocket 的 Instruments channel获取交易参数调整计划的预告。手动交易用户可以通过 交易规则简介 获取最新的交易参数。 详见API 文档：Overview – OKX API guide | OKX technical support | OKX 欧易将持续为您提供更优秀的产品和更优质的服务！ 欧易团队 2025 年 12 月 23 日

openAPI 用户可以通过“查看账户余额接口”或“账户频道”的colRes字段查询币种的全平台质押借币量是否接近上限，或已达到上限、被限制抵押 [查看账户余额] (https://www.okx.com/docs-v5/zh/#trading-account-rest-api-get-balance) [获取子账户交易账户余额] (https://www.okx.com/docs-v5/zh/#sub-account-rest-api-get-sub-account-trading-balance) [账户频道] (https://www.okx.com/docs-v5/zh/#trading-account-websocket-account-channel)超出平台总上限的自动换币 当某币种的全平台质押借币量超出平台总上限一定比例时，对于质押该币种且借币量较大的用户，平台将通过自动换币降低质押借币风险。

GET /api/v5/market/books GET /api/v5/market/books-full WebSocket: books/books5/bbo-tbt/books-l2-tbt/books50-l2-tbt 将新增一个 WebSocket 频道，仅包含所有 ELP 订单 (有效及无效部分)，用户需要结合非 ELP 订单的最佳买入价和卖出价来判断 ELP 订单的有效部分。 WebSocket: books-elp 网页端和 App 端订单簿 ELP 订单将显示在网页端和 App 端界面的订单簿中。但界面中没有特殊标志来表示某些交易产品是否启用了 ELP 功能，或订单簿中是否有 ELP 挂单。 无效的 ELP 订单不会显示在网页端和 App 端的订单簿中，因为它们不参与撮合。 常见问题解答 (FAQ)什么是欧易流动性增强计划 (ELP)？ 欧易流动性增强计划引入了新的只挂单订单类型 (ELP)，旨在提升特定欧易实体下用户的流动性并改善交易执行质量。所有用户都可以通过 OpenAPI 下 ELP 订单。

API 接口调整（不兼容变更） REST GET /api/v5/public/insurance-fund 接口及 WebSocket adl-warning 频道将进行相应调整： regular_update 类型数据将会失效。选择其他类型时会默认传天级最新数据：每日结算后更新一次（约 UTC 08:00）； WebSocket adl-warning 频道将停止在 normal 状态下推送数据；在 warning 或 adl 状态下，数据继续每秒推送一次，但部分字段将返回空值（""）。 如您的应用依赖上述接口的相关字段或推送行为，请在上线日期前完成相应调整。详情请及时留意API文档。 对用户的影响 本次调整不影响您的资产安全，也不改变 OKX 的清算与风险保障机制。 如有疑问，请联系欧易客服。感谢您对欧易的支持。 欧易团队