什么是欧易 WebHook？
随着2026年区块链技术的普及，WebHook 已成为连接交易所与用户业务系统的关键桥梁。欧易（OKX）WebHook 允许用户在特定事件（如订单成交、账户资产变动）发生时，将数据以 HTTP POST 请求的方式实时推送到用户配置的服务器 URL。这解决了传统轮询方式延迟高、资源消耗大的问题。
通过官网入口配置 WebHook，您可以实现毫秒级的数据响应，对于量化交易机器人、风险监控系统以及自动化记账系统至关重要。
配置前的准备工作
在进入官网通道配置参数之前，请确保您的环境满足以下条件：
- 已通过 欧易官网入口 完成实名认证。
- 拥有一个公网可访问的服务器或本地服务（内网穿透也可用于测试）。
- 服务器支持 HTTPS 协议（生产环境强制要求）。
WebHook 设置详细步骤
1
进入 API 管理页面
登录欧易官网，进入【资产管理】或【API管理】板块。在左侧菜单栏中找到【WebHook】或【事件订阅】选项。如果您使用的是移动端，请务必下载上方提供的最新版APP以获取完整功能。
2
创建新的 WebHook 通道
点击“创建 WebHook”，系统将要求您输入基础配置参数。请确保填写的信息准确无误，以免触发验证失败。
3
官网通道配置参数详解
以下为2026年最新版本的配置参数表，请根据您的业务需求进行填写：
| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
callbackUrl |
是 | 用于接收推送数据的回调地址，必须以 https 开头。 |
channelId |
否 | 通道标识，用于区分不同业务线的推送来源（如 ACE531197）。 |
secretKey |
是 | 用于验证签名，请妥善保管，不要泄露。 |
eventType |
是 | 订阅的事件类型，如：order.fill, account.balance 等。 |
4
验证与激活
配置完成后，欧易服务器会向您的回调地址发送一个测试请求。您的服务器需正确响应预设内容才能激活通道。
安全最佳实践
为了保障您的资产与数据安全，欧网 提出以下建议：
IP 白名单
在回调服务器端设置严格的IP白名单，仅接收欧易官方出口IP的请求。
签名校验
务必对每次接收到的 WebHook 请求进行签名验证，防止伪造请求。
常见问题 (FAQ)
为什么我收不到 WebHook 推送？
请检查：1. 回调URL是否可公网访问；2. 服务器防火墙是否放行端口；3. 确认在官网通道配置参数中事件类型是否勾选正确。
WebHook 推送的数据会有延迟吗？
在正常网络环境下，欧易 WebHook 的推送延迟通常在毫秒级别。如果出现持续延迟，可能是您的服务器处理逻辑阻塞了响应。
如何更新回调地址？
您可以随时在欧易官网的 API 管理页面编辑现有的 WebHook 通道，修改 CallbackUrl 后保存即可生效，无需重新创建。