欧易官网的Webhook事件推送有哪些？

欧易欧易 2026-05-16 2

欧易官网Webhook事件推送详解：类型、配置与最佳实践

目录导读

什么是欧易Webhook事件推送？
欧易Webhook的核心事件类型
- 1 交易类事件
- 2 账户资产类事件
- 3 行情与市场数据事件
- 4 风控与系统通知
Webhook的配置与验证流程
常见问题与解决方案（FAQ）
如何利用Webhook提升交易效率？

欧易官网的Webhook事件推送有哪些？-第1张图片-OKX下载-欧易官方全平台-欧易官方全平台客户端

什么是欧易Webhook事件推送？

欧易（OKX）官网提供的Webhook事件推送是一种实时数据回调机制，允许用户或开发者通过HTTP/HTTPS接口，接收交易所发生的特定事件通知，与传统的轮询（Polling）方式不同，Webhook采用“事件驱动”模式——当欧易系统内发生用户预设的事件（如订单成交、账户充值、价格触发等）时,系统会主动向用户指定的URL发送JSON格式的请求数据。

这种机制广泛应用于量化交易、自动化风控、行情监控和通知机器人开发场景，当某个交易对的实时价格跌破阈值时,Webhook可以立即触发你的服务器执行止损指令。

核心特点：

低延迟：事件发生到推送到达通常仅需几百毫秒
去中心化：无需持续占用API连接资源
灵活性：支持自定义事件过滤规则

欧易Webhook的核心事件类型

根据欧易官方文档和实际应用场景,Webhook事件分为四大类：

1 交易类事件

订单状态变更 (Order Completed / Order Canceled / Order Partially Filled)
当你的限价单、市价单或止盈止损单被完全成交、部分成交或撤销时触发，推送内容包括订单ID、成交均价、累计成交量、手续费等。
持仓变动 (Position Changed)
适用于合约交易，当持仓数量、持仓均价或强平价格发生变化时推送（如加仓、减仓、强平）。
策略执行结果 (Strategy Trigger)
通过欧易API绑定的量化策略（如网格交易、DCA定投）完成一次操作后的事件。

2 账户资产类事件

充值到账 (Deposit Completed)
当你的欧易账户收到区块链转账（比特币、以太坊等）并达到确认数后推送，常用于钱包管理系统自动上账。
提币状态更新 (Withdrawal Status)
提币发起后经历“审核中→已发出→链上确认”等阶段时推送，帮助监控提币进度。
资金费率结算 (Funding Fee Settled)
针对永续合约账户,每隔8小时结算资金费率时推送结算明细。

3 行情与市场数据事件

价格告警 (Price Alert Triggered)
用户通过欧易“价格预警”功能设定的上下阈值被突破时推送，支持常见币种（如BTC/USDT、ETH/USDT）。
K线完结 (Candle Closed)
当特定时间周期（1分钟、1小时、1天等）的K线生成完成后推送，包含开盘价、收盘价、最高价、最低价和成交量。
深度快照 (Orderbook Snapshot)
可选配置：当买卖盘口深度发生显著变化（例如买卖价差扩大10%）时推送当前卖一买一价格与挂单量。

4 风控与系统通知

强平通知 (Liquidation)
当你的合约仓位触及强平线并被系统执行时紧急推送，注意：该事件可能晚于实际强平时刻几秒钟。
API密钥失效 (API Key Revoked)
当API密钥被用户手动删除或触发风控自动冻结时推送，用于提醒更新自动化脚本。
系统维护公告 (System Maintenance)
欧易平台发布临时维护或功能升级时推送,帮助用户提前暂停交易机器人。

Webhook的配置与验证流程

步骤1：登录欧易官网并进入API管理

访问欧易官网，进入“账户→API管理”页面。
注意：Webhook是独立于API密钥的功能，需在“Webhook”标签页操作。

步骤2：创建Webhook端点

接收URL：输入你的服务端地址（需为公网可访问，且支持HTTPS协议）。https://your-domain.com/webhook/okx
选择事件：勾选你想订阅的事件类型（至少选择一种，如“订单状态”+“充币到账”）
签名验证：系统会生成一个Secret Key（建议保存），推送时会附带X-OKX-SIGN签名头,你的服务器需用该密钥验证请求真实性。

步骤3：测试与激活

欧易提供“测试订阅”功能：

发送一个模拟事件到你的URL，检查服务器能否正确返回200 OK。
若返回非200（如500/404），系统会认为无效端点，不会继续推送真实事件。
验证成功后，点击“启动”按钮。

步骤4：生产环境部署

心跳检测：欧易每5分钟会发送一个心跳事件（{ "type": "heartbeat" }），若连续3次未收到回复，自动禁用该Webhook。
重试策略：推送失败（网络超时/服务器错误）后，系统会重试最多3次，间隔分别为5秒、30秒、120秒。

常见问题与解决方案（FAQ）

Q1：我订阅了“价格告警”，但为什么没收到推送？

答：请检查：

价格告警需要先在欧易“行情”页面手动设置（Webhook本身不创建告警，只转发告警事件）。
确保触发阈值被正确设定（例如BTC价格突破30000美元）。
查看你的服务器日志,确认事件是否被防火墙或反向代理拦截。

Q2：Webhook推送来的数据格式是什么样的？

答：以“订单完成”事件为例：

{
  "event": "order_completed",
  "data": {
    "instId": "BTC-USDT-SWAP",
    "ordId": "123456789",
    "side": "buy",
    "fillPx": "35000.1",
    "fillSz": "0.1",
    "fee": "-0.00005",
    "ts": "1711843200000"
  }
}

所有字段名称与欧易REST API返回格式一致,但仅包含必要字段。