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

admin 欧易中心 2026-07-15 2

目录导读

欧易API接口概述 – 了解API的作用与适用场景
申请欧易API密钥的完整流程 – 从登录到生成密钥的步骤详解
Postman工具简介与安装 – 为什么选择Postman进行API测试
使用Postman测试欧易API密钥的具体操作 – 请求头、签名生成与请求示例
常见问题与错误排查 – 解决API调用中遇到的典型问题
问答环节 – 针对API使用的高频疑问解答

欧易API接口概述

欧易交易所（OKX）为开发者提供了丰富的RESTful API接口，支持行情查询、账户管理、交易下单、资金划转等功能，通过API，用户可以构建自动化交易策略、量化分析系统或集成第三方应用，本教程将引导你从零开始申请API密钥，并使用Postman工具验证其有效性，值得注意的是，在操作前请确保你已完成欧易交易所下载并注册账户,这是使用API的前提条件。

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

申请欧易API密钥的完整流程

步骤1：登录欧易账户

访问欧易交易所官网，输入你的账户凭证登录，如果尚未注册，请先完成注册并进行身份验证（KYC）。

步骤2：进入API管理页面

登录后，将鼠标悬停在右上角头像处，点击“账户” → “API” （部分版本路径为“开发者” → “API管理”），系统会要求进行安全验证（短信或谷歌验证器）。

步骤3：创建API密钥

点击“创建API Key”,在弹出的窗口中设置：

名称：自定义，如“量化测试Key”
权限：建议先勾选“读取”权限，避免误操作，测试时可选择“交易”权限,但正式使用时需谨慎。
安全设置：绑定IP地址（可留空，但建议填写固定IP以提升安全性）。
到期时间：可设为“永不过期”或自定义时长。

点击“确认”后，系统将生成 API Key 和 Secret Key。务必立即保存Secret Key，因为页面关闭后将无法再次查看,建议复制到本地加密笔记中。

Postman工具简介与安装

Postman是一款流行的API开发与测试工具，支持发送GET、POST、PUT、DELETE等请求，并能直接处理签名生成，官网下载地址为https://www.postman.com/，根据你的操作系统选择对应版本（Windows/macOS/Linux），安装完成后,注册一个免费账号即可使用。

使用Postman测试欧易API密钥的具体操作

以下以调用“获取账号信息”接口（GET /api/v5/account/balance）为例,演示完整测试流程。

1 准备请求参数

在Postman中新建一个Request：

Method：选择GET
URL：填入https://www.okx.com/api/v5/account/balance（欧易官网API端点）
Headers（请求头）：需要添加以下字段：
- OK-ACCESS-KEY：填入你的API Key
- OK-ACCESS-SIGN：签名，需单独生成
- OK-ACCESS-TIMESTAMP：当前UTC时间戳，格式如2023-01-01T12:00:00.000Z
- OK-ACCESS-PASSPHRASE：你在创建API时设置的交易密码（若未设置,则无需此项）

2 生成签名（OK-ACCESS-SIGN）

签名的生成规则较为特殊,需组合以下内容：

时间戳 + 请求方法 + 请求路径 + 请求体（若无体部分则为空） + Secret Key

对于GET请求，请求体为空,则拼接字符串为：

2023-01-01T12:00:00.000ZGET/api/v5/account/balance

然后使用HMAC-SHA256算法，以你的Secret Key作为密钥，对上一步字符串进行加密，结果转为Base64编码。
在Postman中，可以使用“Pre-request Script”自动生成签名，代码如下（JavaScript）：

const timestamp = new Date().toISOString(); // 生成UTC时间戳
const method = 'GET'; // 或POST、PUT等
const requestPath = '/api/v5/account/balance';
const body = ''; // GET请求为空
const secretKey = pm.environment.get('OK_SECRET_KEY'); // 将Secret Key存入环境变量
const sign = CryptoJS.HmacSHA256(timestamp + method + requestPath + body, secretKey).toString(CryptoJS.enc.Base64);
pm.request.headers.add({key: 'OK-ACCESS-TIMESTAMP', value: timestamp});
pm.request.headers.add({key: 'OK-ACCESS-SIGN', value: sign});

3 发送请求并查看响应

点击“Send”按钮，若密钥有效且签名正确,你将收到类似以下响应：

{
  "code": "0",
  "data": [
    {
      "totalEq": "1000.5",
      "details": [...]
    }
  ]
}

如果返回错误码（如50100表示签名错误，50119表示IP未授权）,请检查签名生成逻辑或API权限设置。

常见问题与错误排查

错误码	含义	解决方法
50100	API Key无效或签名错误	检查Secret Key是否准确，签名生成顺序是否正确
50119	IP地址未授权	在API设置中添加当前机器的高德IP白名单
50120	请求频率超限	欧易API有速率限制（如每100ms最多10次请求），请降低请求频率