本教程旨在介绍如何使用基于OKX V5 API的Python做市商样本程序。该项目利用OKX V5 API PYTHON SDK,为用户提供一个构建高效交易系统的解决方案,该系统能够及时精准地订阅市场数据更新、订单更新及账户和仓位更新,基于策略思路发送订单操作请求,并在交易系统顶层编写自定义策略逻辑。本项目仅用于展示或研究目的,强烈建议用户在DEMO交易环境下进行开发。本项目不保证任何盈利策略或流动性提供义务。
前提条件
- Python 版本:≥3.9
- WebSocketAPI:websockets(建议版本6.0)
- 其他依赖:python-okx≥0.1.9, autobahn~=23.1.2, shortuuid~=1.0.11, Twisted~=22.10.0, PyYAML~=6.0
快速开始
- 克隆此项目到本地开发环境。
- 打开项目文件夹
okx-sample-market-maker
,通过命令pip install -r requirements.txt
安装依赖。建议使用virtualenv
创建Python虚拟环境。 - 在OKX账户中切换到demo交易模式,生成DEMO交易API密钥。
- 将API密钥凭证放入
okx_market_market/settings.py
中的相应位置。 - 默认交易工具ID在
okx_market_market/settings.py
中设置为BTC-USDT-SWAP,交易模式为cross。如需更换交易工具,可修改该字段。 okx_market_market/params.yaml
中存储了一系列策略参数,运行前请检查这些参数。- 运行样本做市商,通过IDE或命令行运行主脚本
okx_market_maker/run_sample_market_maker.py
。
交易工具与交易模式
- 非保证金交易:现货和期权买方使用现金模式。
- 单币种保证金账户:隔离保证金、跨保证金、现货使用现金模式。
- 多币种保证金账户:隔离保证金、跨保证金。
- 组合保证金:隔离保证金、跨保证金。
输出示例
- 下单示例:
PLACE ORDER limit buy BTC-USDT-SWAP 2.0 @ 26414.9
- 风险概要示例:时间、自启动以来的盈亏、资产价值变化等。
- 修改订单示例:
AMEND ORDER orderaFZBngCqMjsxVHjDtD2TBC with new size 0 or new price 26444.7
- 取消订单示例:
CANCELING ORDER orderaFZBngCqMjsxVHjDtD2TBC