欧易量化交易需先配置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时，视为完全成交并触发策略下一步动作。
