欧易量化交易需先配置api密钥与权限,再通过rest获取行情、websocket接收实时推送,最后调用交易接口下单并同步订单状态。
欧易okx官网地址:
欧易官方APP下载链接:

一、获取API密钥与权限配置
欧易平台为量化交易者提供标准化REST和WebSocket接口,需通过账户安全中心启用API并绑定IP白名单。该步骤确保调用身份可验证、通信链路受控。
1、登录欧易官网或App,进入「账户中心」→「API管理」页面。
2、点击「创建API」,勾选所需权限:交易、资金、行情、订单等,禁止勾选“删除API”和“提现”权限。
3、设置IP白名单,仅允许填写已知可信服务器或本地开发环境IP,空IP列表将导致接口调用被拒绝。
4、完成短信与谷歌验证器双重认证后,系统生成API Key、Secret Key及Passphrase,Secret Key仅显示一次,务必立即保存。
二、接入REST API获取实时行情数据
REST接口适用于低频策略、行情快照拉取及订单状态轮询,支持HTTP/HTTPS协议,响应格式为JSON,需配合签名机制校验请求合法性。
1、构造请求URL,例如获取BTC-USDT最新价格:https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT。
2、在Header中添加必要字段:Content-Type: application/json;OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP、OK-ACCESS-PASSPHRASE。
3、使用HMAC-SHA256算法对timestamp + method + requestPath + body(若存在)进行签名,时间戳误差须控制在30秒内,否则返回401错误。
4、发起GET请求,解析返回JSON中的"last"字段获取最新成交价,单IP每秒限流20次,超限将触发429响应。

三、建立WebSocket连接接收推送行情
WebSocket接口适用于高频策略,支持全量或指定合约的tick级行情、订单簿深度及成交记录实时推送,降低轮询延迟与服务器负载。
1、连接地址为:wss://ws.okx.com:8443/ws/v5/public(公共频道)或wss://ws.okx.com:8443/ws/v5/private(私有频道)。
2、发送初始化请求,格式为JSON对象:{"op":"subscribe","args":[{"channel":"tickers","instId":"ETH-USDT"}]}。
3、连接成功后,服务端持续推送JSON消息,提取"last"、"bidPx"、"askPx"等字段用于策略计算,每个连接最多订阅100个channel,超出将被断连。
4、监听ping/pong心跳包,客户端需在30秒内响应pong,未响应将导致连接被服务端主动关闭。
四、提交限价单与市价单的API调用流程
交易类接口需使用私有WebSocket或REST通道,依赖签名认证与风控参数校验,支持多币种保证金模式下的订单创建、撤回与查询。
1、通过REST POST请求提交订单,路径为:https://www.okx.com/api/v5/trade/order。
2、请求Body包含instId、tdMode(cash/isolated/margined)、side(buy/sell)、ordType(limit/market)、sz、px(限价单必填)等字段。
3、签名时需将body字符串参与HMAC-SHA256运算,市价单不填px字段,但必须指定sz或quoteSz(以计价币数量下单)。
4、成功返回后获取ordId,可用于后续撤单或查询,同一instId下每秒最多提交5笔新单,超频将触发4001错误码。
五、处理订单状态与成交明细同步
订单执行结果非即时可见,需通过主动查询或订阅事件推送获取最新状态,避免因网络抖动或延迟导致策略逻辑错判。
1、调用REST接口获取未成交订单:GET /api/v5/trade/orders-pending?instId=BTC-USDT。
2、调用接口获取历史成交记录:GET /api/v5/trade/fills?instId=BTC-USDT&limit=100。
3、在私有WebSocket中订阅"orders"与"account"频道,实时接收orderState变更(live/partial-fill/filled/canceled)及盈亏更新。
4、比对本地订单缓存与接口返回的ordId、clOrdId及fillSz,当fillSz > 0且orderState为filled时,视为完全成交并触发策略下一步动作。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











