欧易API接口申请教程，如何使用Postman测试API密钥？

admin okx快讯 2026-06-20 2

📖 目录导读

什么是欧易API接口？为什么交易者需要它？
欧易API密钥申请详细步骤（附注意事项）
Postman基础配置：从零搭建测试环境
手把手教你用Postman测试欧易API密钥
常见问题解答（FAQ）

欧易API接口：量化交易的“钥匙”

如果你经常参与加密货币交易，一定听说过欧易交易所下载后使用API进行自动化交易，欧易API就是欧易官方提供的一套程序接口，允许你用代码或第三方工具直接下单、查询余额、获取行情数据，它就像是给你一把“万能钥匙”，可以绕过繁琐的手工操作,实现策略化交易。

欧易API接口申请教程，如何使用Postman测试API密钥？-第1张图片-欧易交易所

很多新手朋友在欧易交易所官网申请完API后，一脸懵：“我该咋测试这密钥对不对？”别急，今天咱们就用Postman这个免费工具,手把手教你完成测试。

欧易API密钥申请详细步骤

登录账号并进入API管理

打开欧易交易所官网，登录你的账号，在右上角头像处找到“API”或“我的API”入口（不同版本界面可能稍有差异）。

创建新API密钥

点击“创建API”,系统会弹出以下选项：

权限设置：建议先勾选“读取”和“交易”，避免一开始就开放提币权限,更安全。
IP绑定：强烈建议绑定你的服务器或本地IP,防止密钥泄露后被恶意调用。
随便填个名字，TestAPI”,方便管理。

保存密钥与密码

创建成功后,你会看到两串重要字符：

API Key：公钥,用于标识身份。
Secret Key：私钥，务必立即复制保存！关掉页面后就再也看不到了。

⚠️ 注意：有些版本还需要设置“交易密码”或“资金密码”,按照提示完成即可。

Postman基础配置：环境准备

下载并安装Postman

去官网下载Postman客户端（免费版够用）,安装后打开。

新建请求与集合

点击左上角“New” -> “HTTP Request”。
在左侧新建一个“Collection”（集合），命名为“欧易API测试”。

设置环境变量（关键步骤）

点击右上角齿轮图标 -> “Manage Environments” -> 新建环境，OKX_Test”,添加以下变量：

变量名	初始值
`base_url`	`https://www.okzn.com.cn`
`api_key`	你的API Key
`secret_key`	你的Secret Key
`passphrase`	创建API时设置的密码（如有）

为什么要用变量？因为你后续所有接口请求都可以直接引用{{base_url}}，切换环境时只需修改变量值,不用改每个请求的URL。

手把手测试欧易API密钥

第一步：测试账户余额（GET请求）

方法：GET
URL：{{base_url}}/api/v5/account/balance
添加Headers（请求头）：
- OK-ACCESS-KEY：{{api_key}}
- OK-ACCESS-SIGN：需要签名，下面会说
- OK-ACCESS-TIMESTAMP：当前时间戳
- OK-ACCESS-PASSPHRASE：{{passphrase}}

关键步骤：签名生成 欧易的API要求对请求进行HMAC-SHA256签名，你可以在Postman的“Pre-request Script”中写脚本自动生成：

const timestamp = new Date().toISOString();
const message = timestamp + 'GET' + '/api/v5/account/balance';
const sign = CryptoJS.HmacSHA256(message, pm.environment.get('secret_key')).toString(CryptoJS.enc.Base64);
pm.environment.set('OK-ACCESS-SIGN', sign);
pm.environment.set('OK-ACCESS-TIMESTAMP', timestamp);

第二步：发送请求

点击“Send”，如果返回类似{"code":"0","data":[{"totalEq":"0.1",...}]}的JSON数据，恭喜你！API密钥配置成功！若返回错误码（比如50100）,说明签名有误或密钥权限不足。

第三步：测试下单功能（POST请求）

方法：POST
URL：{{base_url}}/api/v5/trade/order
Body：raw -> JSON
```
{
  "instId":"BTC-USDT",
  "tdMode":"cash",
  "side":"buy",
  "ordType":"market",
  "sz":"0.001"
}
```
修改签名脚本中的message为timestamp + 'POST' + '/api/v5/trade/order' + JSON.stringify(body)，即可测试真实下单。建议用极小金额测试。