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

时间：2025-12-07 来源：引擎软件园作者：佚名

欧交易所（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调用步骤如下：

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