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

admin 欧易中心 2026-06-30 1

目录导读

欧易API接口概述与价值
API密钥申请前置条件与流程
Postman环境配置与密钥导入
实战：Postman测试API密钥的完整步骤
常见问题与故障排除
API安全建议与最佳实践

欧易API接口概述与价值

在数字货币交易领域,欧易（OKX）作为全球领先的交易平台，其API接口为开发者提供了自动化交易、市场数据获取、资产管理等核心功能，通过欧易API，用户可以编写程序实现策略交易、实时监控行情波动，或构建自定义交易工具，申请并正确配置API密钥是接入这些功能的第一步，而Postman作为一款流行的API开发测试工具，能帮助用户快速验证密钥的有效性与接口响应。

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

核心提示：无论您是量化交易爱好者还是机构开发者，掌握欧易API接口申请与测试流程，将极大提升交易效率与数据分析能力。

API密钥申请前置条件与流程

1 申请前提

拥有一个已完成KYC认证的欧易交易所下载账户。
账户需完成高级安全验证（如Google Authenticator二次验证）。

2 密钥申请步骤

登录账户：访问欧易交易所官方，进入“账户中心”。
创建API密钥：
- 在“API管理”页面点击“创建新API密钥”。
- 输入密钥名称（建议使用描述性名称，如“量化机器人”）。
- 选择权限类型：
  - 读取权限：仅限于获取行情与账户信息。
  - 交易权限：允许执行买卖操作。
  - 提现权限（不建议开启）：仅在有特殊需求时启用。
安全验证：输入邮件验证码与Google Authenticator动态码。
保存密钥：系统将生成API Key与Secret Key，注意：Secret Key仅显示一次，请务必妥善保存，泄露可能导致资产风险。

注意：创建后，建议立即记录Secret Key到密码管理器，否则需重新创建。

Postman环境配置与密钥导入

Postman是一款强大的API测试工具,支持多种HTTP请求方法（如GET、POST），以下为您配置环境的详细步骤：

1 下载与安装Postman

访问Postman官网下载桌面版应用,支持Windows、macOS、Linux等主流系统。
安装后注册或直接进入工作区。

2 创建欧易API集合

点击左侧“Collections”旁的“+”按钮，新建一个集合，命名为“OKX API”。
在集合内添加请求时,需设置全局变量以简化操作。

3 设置环境变量

点击Postman右上角“Environment”旁的小眼睛图标，选择“Add”。
创建名为“OKX Production”的环境，添加以下变量：
- base_url → https://oe-okor.com.cn
- api_key → 填入您申请的API Key
- secret_key → 填入您的Secret Key
- passphrase → 设置一个复杂的密码短语（如YourStrongPass123），用于签名验证

实战：Postman测试API密钥的完整步骤

1 生成请求签名

欧易API使用HMAC SHA256签名算法进行身份验证，在Postman中可通过“Pre-request Script”自动生成签名，以下为示例脚本（JavaScript）：

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 ? JSON.stringify(pm.request.body) : '';
const message = timestamp + method + path + body;
const secret = pm.environment.get('secret_key');
const signature = CryptoJS.HmacSHA256(message, secret).toString(CryptoJS.enc.Base64);
pm.environment.set('timestamp', timestamp);
pm.environment.set('signature', signature);

2 发送测试请求

示例：获取账户资产信息

请求类型：GET
URL：{{base_url}}/api/v5/account/balance
Headers需包含：
- OK-ACCESS-KEY：{{api_key}}
- OK-ACCESS-SIGN：{{signature}}
- OK-ACCESS-TIMESTAMP：{{timestamp}}
- OK-ACCESS-PASSPHRASE：{{passphrase}}
点击“Send”按钮，如返回{"code":"0","data":[{"totalEq":"1000.00"...}}表示成功。