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

admin ok快讯 2026-07-24 1

目录导读

欧易API接口概述
API密钥申请前置条件
欧易交易所官网API密钥申请步骤
Postman工具安装与配置
使用Postman测试API密钥的完整流程
常见错误排查与问答
安全建议与最佳实践

欧易API接口概述

加密货币交易平台欧易（OKX）提供的API接口是开发者进行程序化交易、市场数据获取及账户管理的核心通道，通过欧易API，用户可以实现自动化策略交易、实时行情监控及资产管理等功能，本文将以欧易交易所官网的API文档为基础，详细讲解如何申请API密钥，并使用Postman这一流行接口调试工具完成密钥有效性验证。

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

在开始之前,请确保您已完成欧易平台的账户注册与身份认证（KYC），如需下载交易客户端，可前往欧易交易所下载页面获取最新版本，所有API请求均需基于HTTPS协议，域名统一使用oy-okzi.com.cn，请勿轻信第三方仿冒站点。

API密钥申请前置条件

在欧易交易所官网申请API密钥前,需满足以下条件：

已完成账户注册并登录
通过初级身份认证（至少提供身份证件）
开启双因素认证（Google Authenticator或短信验证）
了解API权限分类（读取、交易、提现）

注意：若涉及资金操作（如提现API），需额外完成高级认证并绑定IP白名单，建议测试阶段仅开放“读取”权限，避免资产风险。

欧易交易所官网API密钥申请步骤

步骤1：登录欧易官网

访问 oy-okzi.com.cn，输入账号密码及Google验证码完成登录。

步骤2：进入API管理页面

点击个人头像 → “API”
或直接访问“账户中心” → “API管理”

步骤3：创建API Key

点击“创建新的API Key”
输入API名称（如“测试Key”）
选择权限：勾选“读取”即可（测试用）
设置IP白名单（强烈建议填写本机公网IP，格式如0.113.0）
输入资金密码及Google验证码
点击“确认创建”

步骤4：保存密钥信息

创建成功后,系统将显示：

API Key（公钥，形如xxxx-xxxx-xxxx-xxxx）
Secret Key（私钥，仅显示一次，务必保存至安全位置）
Passphrase（交易密码短语，在请求头中必传）

警告：Secret Key泄露可能导致资产损失，请勿截图、分享或存储于云笔记。

Postman工具安装与配置

1 下载与安装

访问Postman官网（postman.com）下载对应操作系统版本，安装后注册或跳过登录。

2 设置环境变量（推荐）

为简化后续测试,可创建欧易API环境：

点击右上角“Environment” → “Add”
添加变量：
- baseUrl = https://oy-okzi.com.cn
- apiKey = 您的API Key
- secretKey = 您的Secret Key
- passphrase = 您的Passphrase

3 导入预置签名脚本

欧易API请求需使用HMAC SHA256签名，Postman可通过“Pre-request Script”自动生成签名，复制以下脚本至请求的“Pre-request Script”选项卡（需根据官方文档调整）：

// 此为示例脚本，需参照欧易官网API文档更新
const timestamp = new Date().toISOString();
const method = request.method;
const path = request.url.replace(pm.environment.get('baseUrl'), '');
const body = request.data || '';
const preHash = timestamp + method + path + body;
const signature = CryptoJS.HmacSHA256(preHash, pm.environment.get('secretKey')).toString(CryptoJS.enc.Base64);
pm.request.headers.add({ key: 'OK-ACCESS-TIMESTAMP', value: timestamp });
pm.request.headers.add({ key: 'OK-ACCESS-SIGN', value: signature });
pm.request.headers.add({ key: 'OK-ACCESS-KEY', value: pm.environment.get('apiKey') });
pm.request.headers.add({ key: 'OK-ACCESS-PASSPHRASE', value: pm.environment.get('passphrase') });

使用Postman测试API密钥的完整流程

1 测试获取账户信息

以欧易“获取账户资产”接口为例（GET请求）：

URL：https://oy-okzi.com.cn/api/v5/account/balance
方法：GET
请求头：由Pre-request Script自动添加
点击“Send”

2 验证返回结果

成功响应返回JSON格式,示例：

{
  "code": "0",
  "data": [{
    "uTime": 1692000000,
    "totalEq": "1000.00",
    "details": [{"ccy": "USDT", "eq": "1000.00"}]
  }]
}

code: "0" 表示请求成功
data 中包含总权益（totalEq）及各币种余额

3 测试带参数的请求

尝试获取指定币种行情（例如BTC/USDT）：

URL：https://oy-okzi.com.cn/api/v5/market/ticker?instId=BTC-USDT
方法：GET
无需额外签名（公开接口）
返回包含最新价、24小时涨跌等数据

4 批量测试常用接口

可使用Postman的“Collection Runner”同时对多个接口进行回归测试，确保密钥在所有场景下均有效。

常见错误排查与问答

Q1: 为什么返回“签名错误”？

答：常见原因包括：

Secret Key未正确复制（大小写或末尾空格）
时间戳与服务端偏差超过30秒（校准系统时间）
Pre-request Script中path拼接错误（应去除baseUrl）

Q2: Postman提示“IP地址未授权”？

答：请登录欧易交易所官网的API管理页面，检查IP白名单是否包含您的当前出口IP（可通过查询ifconfig.me获取），若使用动态IP，建议暂时关闭IP限制（不推荐）。

Q3: 为何测试提现API时提示“权限不足”？

答：创建API Key时未勾选“提现”权限，注意：提现权限风险极高，建议仅在生产环境且绑定IP白名单后启用。

Q4: 可以同时在多个脚本中使用同一个API Key吗？

答：可以，但若IP白名单未设置或太宽松，可能被滥用，建议为不同应用创建独立API Key，并设置不同的IP白名单。

Q5: 如何确认请求签名生成逻辑？

答：请以欧易官网API文档（docs.oy-okzi.com.cn）为准，签名示例代码支持Python、JavaScript、Java等语言，Postman脚本需手动实现签名算法，或使用官方提供的SDK。

安全建议与最佳实践

最小权限原则：测试阶段仅开放“读取”权限；生产环境按需开放交易权限，避免提现权限。
IP白名单：务必设置，仅允许受信任的服务器IP访问。
定期轮换密钥：每3-6个月更换一次API Key。
密钥存储：使用密码管理器或硬件加密设备保存Secret Key和Passphrase。
监控异常：在欧易交易所官网的API管理页面查看历史调用记录，识别可疑行为。

如需更深入学习API开发,可参考欧易官方文档中的WebSocket实时行情及订单簿接口，完成上述步骤后，您已掌握在Postman中测试欧易API密钥的核心技能，可进一步开发自动化交易策略或数据分析工具。

通过本文的目录导读、步骤详解及问答环节，您应当能够独立完成从API密钥申请到Postman测试的全流程，请始终关注欧易交易所官网的安全公告，及时更新您的密钥与程序配置。