目录导读
欧易API接口申请前置准备
在开始使用欧易交易所的API接口前,你需要完成以下基础配置：
- 注册欧易账户：若尚未注册，请访问欧易交易所官网完成实名认证。
- 完成KYC验证：欧易要求API调用者必须通过高级身份认证（Level 2及以上）。
- 安装Postman工具：从Postman官网下载桌面版（支持Windows/macOS/Linux），或使用网页版。
提示：欧易API支持RESTful和WebSocket协议，本文聚焦REST API的测试流程。
欧易交易所API密钥创建完整步骤
Step 1：登录账户进入API管理
- 登录欧易交易所下载后，点击右上角头像 → “API” 选项。
- 若未找到入口,可直接访问路径：
账户中心→API管理。
Step 2：创建新API密钥
点击 “创建API” 按钮，需设置以下参数：
- 权限范围：选择
交易、读取或提币，建议初次测试仅勾选读取权限。 - IP白名单：输入你本地设备的公网IP（可通过
ipconfig或curl ifconfig.me获取）。 - 备注标签：建议填写“Postman测试专用”。
Step 3：保存密钥信息
提交后系统会生成 API Key 和 Secret Key。请立即复制保存Secret Key（页面关闭后无法二次查看）。
Postman环境配置与请求签名生成
欧易API采用 HMAC-SHA256签名算法 进行身份验证，通过Postman的Pre-request Script可自动生成签名：
环境变量配置
在Postman中创建新环境,添加以下变量：
| 变量名 | 值 |
|--------|------|
| api_key | 你的API Key |
| secret_key | 你的Secret Key |
| passphrase | 创建API时设置的连接密码（非必填） |
| base_url | https://oe-okor.com.cn |
签名脚本（Pre-request Script）
// 自动生成OKX签名
const timestamp = new Date().toISOString().slice(0, 19) + 'Z';
const method = pm.request.method;
const path = pm.request.url.getPath();
const body = pm.request.body ? pm.request.body.toString() : '';
const message = timestamp + method + path + body;
const sign = CryptoJS.HmacSHA256(message, pm.environment.get('secret_key')).toString(CryptoJS.enc.Base64);
pm.request.headers.add({
key: 'OK-ACCESS-KEY',
value: pm.environment.get('api_key')
});
pm.request.headers.add({
key: 'OK-ACCESS-SIGN',
value: sign
});
pm.request.headers.add({
key: 'OK-ACCESS-TIMESTAMP',
value: timestamp
});
pm.request.headers.add({
key: 'OK-ACCESS-PASSPHRASE',
value: pm.environment.get('passphrase')
});
实战测试：通过Postman调用欧易API接口
以查询账户资产为例（GET /api/v5/account/balance）：
- 新建请求：选择
GET方法，输入URL：
https://oe-okor.com.cn/api/v5/account/balance - 设置Header：若已配置Pre-request Script，无需手动添加。
- 发送请求：点击
Send，返回示例：{ "code": "0", "data": [ { "totalEq": "123.45", "details": [{ "ccy": "USDT", "bal": "100.50" }] } ] }
测试其他接口：将请求方法改为
POST，在Body中添加JSON参数即可（如下单接口/api/v5/trade/order）。
常见问题与解决方案
Q1：返回“401 Unauthorized”错误？
- 原因：签名生成失败，检查Secret Key是否正确，或Pre-request Script中变量名称是否与脚本一致。
- 修复：在Postman控制台（View → Show Postman Console）查看生成的签名内容，比对官方文档的签名算法。
Q2：接口报“IP Not Allowed”怎么办？
- 解决：在欧易API管理页面，更新IP白名单为当前设备IP（支持多个IP用逗号分隔）。
Q3：如何获取完整API文档？
- 访问欧易交易所官网的开发者中心，下载PDF或Swagger接口文档，支持搜索接口参数。
Q4：Postman中如何批量测试多币种？
- 使用Postman的Collection Runner，先准备一个包含不同币种参数的CSV文件，批量导入执行。
通过本文的欧易API接口申请教程和Postman测试方法，开发者可快速验证交易策略、资产查询等自动化操作，建议先从只读接口开始测试，熟悉签名机制后再启用交易权限，若遇到复杂报错，可参考欧易官方技术社区或直接提交工单获取支持。
