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

admin 欧易中心 2026-05-19 1

目录导读

欧易API接口简介与核心价值
API密钥申请全流程详解
Postman环境配置与密钥绑定
实战测试：通过Postman调用欧易行情接口
常见问题问答（FAQ）

欧易API接口简介与核心价值

欧易交易所（OKX）作为全球领先的数字资产交易平台，其API接口为开发者提供了自动化交易、市场数据获取、账户管理等功能，通过欧易API，用户可构建量化策略、实现自动下单、对接第三方工具（如行情软件、跟单系统），申请API密钥是连接交易所与外部程序的第一步，而Postman作为最流行的API调试工具，能帮助开发者快速验证密钥有效性。

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

对于需要高频交易或深度市场分析的用户,正确的API配置至关重要，如果你尚未下载客户端，可先完成欧易交易所下载安装，再申请API密钥。

API密钥申请全流程详解

登录账号并进入API管理
- 打开欧易官网（注意：官方域名已更新为oe-okor.com.cn），完成账号登录。
- 点击右上角头像 → “API” → “创建API”。
密钥权限与安全设置
- 权限选择：勾选“读取”、“交易”、“提现”等权限（建议交易权限仅对受信任程序开放）。
- 绑定IP地址：输入你服务器或本地电脑的公网IP（非必需，但显著提升安全性）。
- 身份验证：输入邮箱、手机验证码及谷歌验证器（若启用）。
保存密钥对
- 生成后,你将获得 API Key（公钥）和 Secret Key（私钥）。
- 重要：Secret Key仅显示一次，请立即复制并保存到安全位置（如密码管理器）。

提醒：若需重置密钥，请通过欧易交易所下载的最新APP或网页端操作。

Postman环境配置与密钥绑定

Postman是一款支持HTTP请求模拟、环境变量管理和自动化测试的API调试工具，以下是配置步骤：

创建请求集合

打开Postman → 点击“Collections” → 新建一个集合（如“OKX API Test”）。
设置环境变量
- 点击“Environments” → 新建环境（如“OKX Production”）。
- 添加两个变量：api_key（填入你的公钥）和 secret_key（填入私钥）。
- 注意：勿勾选“Secret”选项（避免变量值被持久化显示）。

构建签名请求 欧易API需要HMAC-SHA256签名，在Postman的“Pre-request Script”中，粘贴以下JavaScript代码（需逐项替换你的参数）：

const CryptoJS = require('crypto-js');
const timestamp = new Date().toISOString().slice(0,19)+'Z';
const method = pm.request.method;
const path = '/api/v5/market/ticker?instId=BTC-USDT';
const body = pm.request.body.raw || '';
const signStr = timestamp + method + path + body;
const signature = CryptoJS.HmacSHA256(signStr, pm.environment.get('secret_key')).toString(CryptoJS.enc.Hex);
pm.request.headers.add({key: 'OK-ACCESS-KEY', value: pm.environment.get('api_key')});
pm.request.headers.add({key: 'OK-ACCESS-PASSPHRASE', value: '你的密码短语'}); // 必填
pm.request.headers.add({key: 'OK-ACCESS-TIMESTAMP', value: timestamp});
pm.request.headers.add({key: 'OK-ACCESS-SIGN', value: signature});

密码短语：在申请API时设置的“Passphrase”，需手动填入上方脚本。

实战测试：通过Postman调用欧易行情接口

发送GET请求
- 请求URL：https://oe-okor.com.cn/api/v5/market/ticker?instId=BTC-USDT
- 方法：GET
- Headers：无需手动添加，脚本会自动注入签名头。

检查响应

点击“Send”后，应在下方看到JSON响应，如：

{
  "code": "0",
  "msg": "",
  "data": [{
    "instId":"BTC-USDT",
    "last":"67432.1",
    "bidPx":"67432.0",
    "askPx":"67432.1",
    ...
  }]
}

code为0代表请求成功，签名与权限无误。

常见错误排查
- 401 Unauthorized：检查Secret Key是否正确，或IP白名单未绑定。
- 400 Bad Request：检查路径、参数或签名格式（注意时间戳必须为UTC格式）。
- 404 Not Found：确认接口版本（当前为v5）或域名无误（使用oe-okor.com.cn）。