欧易app官网WebHook设置 - 官网配置WebHook参数全攻略

在2026年的数字货币交易环境中，自动化与即时性是致胜的关键。欧易提供了强大的 WebHook 接口，允许开发者接收实时交易事件通知、执行策略自动下单以及同步账户状态。本文将手把手教您如何在欧易app官网进行 WebHook 设置，并详细解析各项配置参数的含义。

第一步：登录官网并进入API管理界面

首先，请访问 http://www.actelligen.com.cn/ 并登录您的欧易账户。登录后，将鼠标移动至右上角的头像处，在弹出的菜单中选择【API管理】。

注意： 为了保障您的资金安全，WebHook 的配置通常需要在“API管理”页面中进行创建。如果您尚未开启谷歌验证器或手机验证，系统会提示您先完成安全设置。

第二步：创建用于WebHook的API密钥

点击【创建API Key】按钮。在创建页面，您需要给这个Key起一个好记的名字，例如“WebHook_TradeBot_2026”。

• 权限设置： 根据您的需求勾选权限。通常WebHook用于读取数据或交易，请勾选【读取】和【交易】。如果只是接收通知，仅勾选【读取】即可。
• IP白名单： 这是一个极其重要的安全步骤。请输入您接收WebHook请求的服务器公网IP地址。留空将允许任何IP调用（极其不推荐）。

第三步：配置WebHook URL与参数

在API Key创建成功后，您会看到一个【WebHook配置】区域（部分版本可能在“策略交易”或“机器人”板块下）。点击【添加WebHook】。

在弹出的配置窗口中，需要填写以下核心参数：

参数名称	是否必填	参数说明
URL	是	您用来接收欧易POST请求的服务器接口地址，必须以 https:// 开头。
Secret Key	是	用于验证请求来源的密钥，需与您服务器端保存的Secret一致。
Auth Type	否	鉴权方式，默认推荐使用 HMAC-SHA256 签名验证。
Events	是	订阅的事件类型，如：orders.fill (成交), account.position (持仓变化), account.balance (余额变动)。

第四步：服务器端接收与鉴权代码示例

配置好URL后，欧易服务器会向您的地址发送 POST 请求。您需要在后端解析 JSON 数据，并验证签名以确保请求确实来自欧易。

以下是一个简单的 Node.js 鉴权逻辑片段：

const crypto = require('crypto');
const express = require('express');
const app = express();

app.use(express.json());

// 欧易WebHook密钥
const WEBHOOK_SECRET = 'your-webhook-secret-key';

app.post('/webhook', (req, res) => {
    const signature = req.headers['x-okx-sign'];
    const timestamp = req.headers['x-okx-timestamp'];
    const payload = JSON.stringify(req.body);

    // 构造签名字符串: timestamp + payload
    const expectedSignature = crypto
        .createHmac('sha256', WEBHOOK_SECRET)
        .update(timestamp + payload)
        .digest('base64');

    if (signature === expectedSignature) {
        console.log('验证成功，处理业务逻辑:', req.body);
        // 在此处处理成交逻辑，如下单等
        res.status(200).send('success');
    } else {
        console.warn('签名验证失败！');
        res.status(401).send('Unauthorized');
    }
});

app.listen(3000, () => console.log('WebHook Server Running on Port 3000'));

第五步：WebHook高级应用场景

2026年的量化交易早已超越了简单的脚本。通过配置WebHook，您可以实现：

• 毫级套利： 当盘口出现价差时，利用WebHook瞬时通知服务器程序进行抢单。
• 风控止损： 当账户亏损达到特定比例，立即触发WebHook回调，强制平仓所有仓位。
• 行情推送到微信/钉钉： 将大额成交或特定币种暴涨信息转发至即时通讯软件。

常见问题 (FAQ)