📖 目录导读
- 什么是欧易API接口？为什么要申请？
- 申请欧易API密钥的完整步骤
- Postman工具安装与环境配置
- 如何使用Postman测试API密钥？
- 常见问题与避坑指南
什么是欧易API接口？为什么要申请？
很多用户在欧易交易所下载后，会发现平台提供了API接口功能，欧易API是一套程序化交易工具，允许开发者或高级交易者通过代码直接操作账户，比如查询余额、下单、撤单等。
为什么要申请API？
- 实现自动化交易策略（如网格交易、套利）
- 快速获取实时行情数据
- 接入第三方交易工具或量化平台
API密钥就像你的账户“钥匙”，务必妥善保管，切勿泄露给他人，建议在欧易交易所官网申请时，勾选“仅读取”权限,避免不必要的风险。
申请欧易API密钥的完整步骤
第一步：登录欧易交易所官网
打开浏览器访问：https://okjb.com.cn （欧易官方授权合作入口），登录你的账户，如果还没有账号，建议先完成KYC认证,否则API功能可能受限。
第二步：进入API管理页面
- 点击右上角头像 → “API管理”
- 选择“创建API密钥”
- 系统会弹出安全验证（短信/邮箱/谷歌验证器）
第三步：设置API权限
这里要特别注意权限设置：
- 读取权限：建议必选（查询余额、订单）
- 交易权限：按需开启（如需自动下单）
- 提现权限：强烈建议不勾选，防止密钥泄露后资金被盗
点击“创建”,会生成两串关键信息：
- API Key（公钥）
- Secret Key（私钥，只显示一次,务必保存）
❗ 重要提醒：Secret Key 一旦关闭页面就无法再次查看，建议复制到安全的地方,比如密码管理器。
Postman工具安装与环境配置
Postman是测试API接口最常用的工具,免费且支持多种请求格式。
下载与安装
搜索“Postman官网”下载桌面版，注册一个账号（免费）。
配置欧易API环境变量
为了让Postman顺利调用欧易API,需要设置环境变量：
- 点击Postman左上角“Environments”
- 新建一个环境（如“OKX_API”）
- 添加两个变量：
apiKey（填入你的API Key）secretKey（填入你的Secret Key）
这样后续请求可以直接引用变量,避免明文暴露密钥。
如何使用Postman测试API密钥？
示例：查询账户余额（GET请求）
这是最基础的测试,用于验证API是否生效。
步骤：
- 在Postman中新建请求，选择“GET”
- 输入欧易API接口地址：
https://www.okx.com/api/v5/account/info
注意：欧易国际站使用www.okx.com，国内用户可通过okjb.com.cn获取最新域名 - 在“Headers”标签页添加以下参数：
OK-ACCESS-KEY：{{apiKey}}OK-ACCESS-SIGN：需要计算签名（见下文）OK-ACCESS-TIMESTAMP：当前UTC时间戳（格式：2024-01-01T00:00:00.000Z）OK-ACCESS-PASSPHRASE：你在创建API时设置的口令
如何生成签名（Sign）？
欧易API要求对请求进行签名验证，Postman可以通过“Pre-request Script”自动计算，但新手更推荐使用官方提供的API签名生成器，或者直接复制以下代码片段（需要一定编程基础）。
简易方法： 使用在线时间戳工具获取当前UTC时间，手动拼接字符串后通过MD5加密，不过最稳妥的方案是，在欧易交易所下载的开发者文档页面，找到“API签名示例”直接复制现成的。
发送请求查看结果
点击“Send”，如果返回类似以下内容,说明API密钥配置成功：
{
"code": "0",
"data": [{
"totalEq": "100.0",
"details": [...]
}]
}
常见错误码：
50100：API Key无效（检查是否复制完整）50102：时间戳偏差过大（调整服务器时间,误差不能超过30秒）50105：签名错误（检查Secret Key和签名算法）
常见问题与避坑指南
Q1：为什么我的API请求总显示“签名错误”？
A：99%的原因是时间戳格式不对，欧易要求精确到毫秒的UTC时间，且误差不超过30秒，建议用Postman的“Pre-request Script”自动获取时间戳,或者同步电脑时间。
Q2：API密钥可以用于哪些交易操作？
A：取决于权限设置，只开启“读取”的话，只能查询行情和资产；开启“交易”后才能下单，如需高频交易，建议在欧易交易所官网重新创建专用API,限制单日交易次数。
Q3：API密钥泄露了怎么办？
A：立即登录欧易交易所下载后的账户后台，在API管理页面删除该密钥，重新生成新的,同时检查账户是否有异常交易记录。
Q4：Postman测试成功了，但程序里调用却失败？
A：检查网络环境，部分海外API需要科学上网，或者使用欧易亚太区节点，推荐通过okjb.com.cn获取最新的接入点地址。
Q5：API调用频率有限制吗？
A：有，欧易API对个人账户有速率限制，比如每秒最多10次请求，超出会暂时封禁，建议在程序中加入延迟（如0.1秒）。
申请欧易API接口并不复杂，关键步骤无非是：登录官网创建密钥 → 设置权限 → 用Postman测试，新手最容易踩坑的地方是签名计算和时间戳，但只要严格按照官方文档操作,通常一次就能成功。
建议先把API权限设为“仅读取”，测试完全通过后再开启交易权限，如果你在测试中遇到任何问题，不妨回到欧易交易所下载的帮助中心,那里有更详细的API文档和示例代码。
