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

admin ok快讯 2026-07-19 1

目录导读

欧易API接口概述
申请欧易API密钥的详细步骤
Postman环境配置与基本操作
使用Postman测试欧易API密钥的实操流程
常见问题与解答（FAQ）

欧易API接口概述

欧易（OKX）作为全球领先的加密货币交易平台，其API接口为开发者提供了高效的交易、行情查询及资产管理功能，通过API，用户可以自动化执行交易策略，或与第三方工具（如量化机器人、分析软件）对接，对于刚接触API的开发者，欧易交易所下载后，第一步便是申请API密钥并验证其可用性，本教程将重点演示如何用Postman这一主流API调试工具对密钥进行测试，确保接口调用畅通无阻。

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

在开始之前,建议您先访问欧易官网了解基本规则，完成账号注册与身份认证后，即可进入API管理后台。

申请欧易API密钥的详细步骤

1 登录账号并进入API管理页面

打开欧易官网（https://ox-okbb.com.cn/），登录您的账号，在个人中心找到“API”或“API管理”选项，点击进入，若您尚未完成KYC验证，系统会提示先提交身份信息。

2 创建新API密钥

点击“创建API”按钮，系统弹出配置窗口，您需要选择权限范围：通常建议仅勾选“读取”与“交易”权限，避免开放“提现”权限以降低风险，设置IP白名单（可选）可进一步提升安全性。

生成密钥后,页面会显示API Key和Secret Key（后者仅展示一次，务必妥善保存，如截图或复制至密码管理器）。

3 注意事项

不要将Secret Key明文存储在代码或公开文件中。
建议为不同用途创建独立密钥,例如交易机器人与行情监控分开使用。

完成申请后,即可进入下一步——用Postman验证密钥是否生效。

Postman环境配置与基本操作

Postman是一款广泛使用的API开发协作工具,支持发送HTTP请求、管理环境变量以及查看响应数据，以下是配置流程：

1 下载与安装Postman

访问Postman官网下载对应操作系统的版本,安装后启动，首次使用建议注册免费账号，便于同步集合与历史记录。

2 设置环境变量

为了测试欧易API,我们需要定义公共参数，点击Postman右上角的“Environment”按钮，新建一个环境（如“OKX_TEST”），添加以下变量：

base_url：值为 https://www.okx.com（欧易API域名）
api_key：值为您刚申请的API Key
secret_key：值为您申请的Secret Key
passphrase：创建API时设置的访问密码（如有）

3 导入官方API集合（可选）

欧易提供了公开的API文档,您可下载其官方Postman集合文件，直接导入后使用，若自行创建，则需手动添加请求头与签名逻辑。

使用Postman测试欧易API密钥的实操流程

下面以“获取账户资产信息”为例，演示如何发送带签名的请求。

1 构造请求

在Postman中点击“New Request”，选择 GET 方法。
输入URL：{{base_url}}/api/v5/account/balance。
填写请求头（Headers）：
- OK-ACCESS-KEY：{{api_key}}
- OK-ACCESS-SIGN：稍后通过预请求脚本生成
- OK-ACCESS-TIMESTAMP：当前UTC时间戳，如 2025-01-01T00:00:00.000Z
- OK-ACCESS-PASSPHRASE：{{passphrase}}

2 自动生成签名（Pre-request Script）

由于欧易API要求对请求进行HMAC-SHA256签名，我们需在Postman的“Pre-request Script”中插入以下JavaScript代码：

const timestamp = new Date().toISOString().slice(0, -5) + 'Z';
const method = request.method;
const path = '/api/v5/account/balance';
const body = request.data ? JSON.stringify(request.data) : '';
const signStr = timestamp + method + path + body;
const signature = CryptoJS.HmacSHA256(signStr, pm.environment.get('secret_key')).toString(CryptoJS.enc.Base64);
pm.environment.set('timestamp', timestamp);
pm.environment.set('signature', signature);

然后在请求头中使用 {{timestamp}} 和 {{signature}} 替代固定值。

3 发送请求并查看结果

点击“Send”按钮，若密钥无误，响应体将返回账户的资产列表，

{
  "code": "0",
  "data": [{"currency": "BTC", "balance": "0.001"}]
}

若收到 code: 50013 或 400 错误，请检查签名算法、时间戳格式或权限设置。

4 常见错误排查

401 Unauthorized：通常因签名不匹配，需核对Secret Key与签名脚本。
IP限制：若启用了IP白名单，确保当前网络IP在允许范围内。
权限不足：创建API时未勾选对应权限，返回“authorization failed”提示。

通过以上步骤,您已成功使用Postman验证了欧易API密钥。

常见问题与解答（FAQ）

Q1：Postman测试API时，提示“timestamp invalid”如何处理？
A：请检查时间戳是否为UTC格式，且与服务器时间偏差在30秒内，可在Pre-request Script中使用new Date().toISOString()生成标准时间。

Q2：可以在测试环境中使用真实账户吗？
A：建议先使用子账户或小额资产进行测试，避免因脚本错误造成损失，欧易提供了模拟盘（Demo）环境，其API地址不同，需单独申请。

Q3：欧易API的请求频率限制是多少？
A：根据文档，普通用户每2秒最多1次请求，VIP用户每0.1秒1次，高频访问会被暂时封禁，可通过队列或限速机制控制。

Q4：除了Postman，还有哪些工具可测试欧易API？
A：curl命令行、Python的requests库、Insomnia等均可，Postman因其可视化界面和脚本功能，对新手更友好。

Q5：如果忘记Secret Key怎么办？
A：无法找回，只能删除旧密钥并重新申请，务必在创建时备份至安全位置，如密码管理软件。

通过本教程,您已掌握从申请欧易交易所下载到使用Postman测试API密钥的全流程，无论是开发交易机器人还是集成数据看板，熟练操作API将大幅提升您的投资效率，如需深入学习，建议查阅欧易官方API文档并结合本教程反复实践。

标签： Postman测试