欧交易所API使用指南，从入门到实战

  欧交易所（OKX）作为全球领先的数字资产交易平台，其API接口为开发者、量化交易者和高频用户提供了自动化交易、数据获取等高效工具，本文将详细介绍欧交易所API的使用方法,帮助用户快速上手。

API申请与配置

  需登录欧交易所官网进入“API管理”页面，创建API密钥，创建时需设置权限（如“只读”“交易”“提现”等），建议根据最小权限原则分配，避免安全风险，需设置IP白名单（限制访问IP，防止密钥泄露）并开启“二次验证”（如谷歌验证器），增强安全性，生成后，系统会显示API Key、Secret Key和Passphrase（口令），Passphrase仅首次创建可见，需妥善保存。

核心功能与调用方式

  欧交易所API支持RESTful和WebSocket两种接口，分别适用于不同场景：

• RESTful API：用于一次性请求，如获取账户余额、下单、查询订单历史等，通过GET /api/v5/account/balance可获取账户资产，需在请求头中加入API-Key、Passphrase及签名（使用HMAC-SHA256算法，将请求参数与Secret Key拼接后加密）。
• WebSocket API：适用于实时数据推送，如订阅行情数据（K线、深度）、订单状态更新等，需先建立WebSocket连接，发送订阅指令（如{"op":"subscribe","args":["spot/ticker:BTC-USDT"]}），即可实时接收数据。

实战示例：下单流程

  以“买入BTC-USDT限价单”为例，RESTful API调用步骤如下：

1. 构造请求参数：包括instId（产品ID，如BTC-USDT）、tdMode（交易模式，如cash）、side（方向，buy）、ordType（订单类型，limit）、px（价格）、sz（数量）等。
2. 生成签名：将请求参数按字母序排序，拼接成字符串，再用Secret Key进行HMAC-SHA256加密，得到签名值。
3. 发送请求：通过POST方法调用/api/v5/trade/order接口，在请求头中添加API-Key、Passphrase、Timestamp（UTC时间戳）、Sign（签名），Body为JSON格式的参数。
4. 处理响应：成功返回订单ID，失败则根据错误码（如50100参数错误）调整请求。

注意事项

1. 频率限制：API有调用次数限制（如普通用户100次/秒），超频会返回429错误，需合理控制请求频率。
2. 错误处理：需捕获常见错误（如签名错误、余额不足），通过错误码（如50018签名无效）排查问题。
3. 安全防护：定期更换API密钥，避免在代码中硬编码密钥，建议使用环境变量存储。

  通过合理配置和使用欧交易所API，用户可高效实现自动化交易、策略回测等操作，大幅提升交易效率，建议先在测试网（欧交易所提供模拟环境）调试,确保逻辑无误后再接入实盘。