ouyi API新手接入路线图
第一步,注册后完成身份验证,再进API管理页创建Key,权限只勾选“读取”和“交易”,提现先不开。第二步,把服务器公网IP填入白名单,本地调试先用沙盒Key。第三步,用官方签名示例跑通一个查询接口,确认时间戳和签名逻辑无误。第四步,逐步接入下单、撤单和行情推送,每次只加一个端点,观察日志返回码。第五步,上线前设置频率限制和异常告警,避免策略失控。
先确认参数是否按字典序拼接、时间戳是否在30秒内、HMAC密钥是否用对。常见坑是GET请求把参数放进了body而不是query,或者对空值参数做了签名。
ouyi API支持按读、交易、提现拆开授权,只给策略需要的权限,避免一个Key泄露导致全盘失控。
技术上可以,但不建议。不同策略混用一个Key,日志难区分,权限也无法单独回收。建议按策略拆分Key,各自绑定IP和权限。

第一步,注册后完成身份验证,再进API管理页创建Key,权限只勾选“读取”和“交易”,提现先不开。第二步,把服务器公网IP填入白名单,本地调试先用沙盒Key。第三步,用官方签名示例跑通一个查询接口,确认时间戳和签名逻辑无误。第四步,逐步接入下单、撤单和行情推送,每次只加一个端点,观察日志返回码。第五步,上线前设置频率限制和异常告警,避免策略失控。
请求时间戳超出30秒即拒绝,重放旧请求无效,减少截获后二次利用的空间。
绑定服务器出口IP后,其他地址拿Key也调不通,把盗用风险压到网络层。

官方提供多语言签名代码片段,覆盖Python、Java和Node.js,减少手写HMAC的出错概率。
WebSocket断开后先重连,再用REST接口拉取最近成交和深度快照补齐缺口。代码里要加心跳检测和自动重连,避免静默断线导致策略用旧数据。
独立测试网Key可模拟下单和撤单,不碰真实资金,适合上线前跑通全流程。



立刻登录后台删除该Key,重新创建并绑定IP白名单。检查调用日志是否有异常IP和陌生端点,如有提现权限被开启的记录,马上联系客服冻结账户。
有,不同端点限制不同,下单类通常比查询类更严。超限返回429,建议在代码里加退避重试,并错开批量请求的时间分布。
支持一次请求提交多笔订单,减少网络往返次数,适合网格和分批建仓策略。

默认关闭提现权限,需要时单独开启并配合IP白名单,降低大额资产被转走的风险。

光看不如跑一遍。注册后创建你的第一个沙盒Key,按文档调通签名请求,亲眼看看权限和IP白名单怎么拦下越权调用。