🔥 OKX
基金会合作伙伴
OKX 是 Hummingbot 基金会的 交易所合作伙伴,因此当您使用 Hummingbot 在 OKX 上运行机器人时,部分交易手续费将用于支持基金会及其通过开源软件普及算法交易的使命。为帮助我们,可通过我们的 OKX 推荐链接 创建账户,并将该账户的 API 密钥输入 Hummingbot 启动机器人!感谢您的支持!🙏
🛠 连接器信息¶
- 交易所类型:中心化交易所 (CEX)
- 市场类型:限价订单簿 (CLOB)
| 组件 | 状态 | 连接器版本 | V2 策略 | 备注 | 
|---|---|---|---|---|
| 🔀 现货连接器 | ✅ | v2.1 | 是 | |
| 🔀 永续合约连接器 | ✅ | v2.1 | 是 | |
| 🕯 现货 K 线数据流 | 未构建 | |||
| 🕯 永续合约 K 线数据流 | ✅ | 
ℹ️ 交易所信息¶
- 官网: https://www.okx.com/
- CoinMarketCap: https://coinmarketcap.com/exchanges/okx/
- CoinGecko: https://www.coingecko.com/en/exchanges/okx
- API 文档: https://www.okx.com/docs-v5/en/#overview
- 手续费: https://www.okx.com/fees
- OKX 推荐链接: https://www.okx.com/join/1931920269
🔑 如何连接¶
生成 API 密钥¶
- 登录您的 OKX 账户并点击用户图标
- 从下拉菜单中选择 API
- 选择您要创建 API 密钥的账户
- 点击“创建 API 密钥”
将密钥添加到 Hummingbot¶
在 Hummingbot 客户端内运行 connect okx:
>>> connect okx
Enter your okx API key >>>
Enter your okx secret key >>>
Enter your okx passphrase >>>
若连接成功:
🔀 现货连接器¶
对接现货市场 API 接口
- ID: okx
- 连接类型:WebSocket
- 文件夹: https://github.com/hummingbot/hummingbot/tree/master/hummingbot/connector/exchange/okx
订单类型¶
此连接器支持以下 OrderType 常量:
- LIMIT
- LIMIT_MAKER
模拟交易¶
通过运行 connect okx_paper_trade(而非 connect okx)可使用此连接器的 模拟交易 版本。
如果默认不可用,您可以配置 Hummingbot 以添加此模拟交易交易所。更多信息请参见添加交易所。
🔀 永续合约连接器¶
集成永续合约市场 API 端点
- ID: okx_perpetual
- 连接类型:WebSocket
- API 文档: https://www.okx.com/docs-v5/en/
- Github 文件夹
订单类型¶
此连接器支持以下 OrderType 常量:
- LIMIT
- MARKET
使用方法¶
- 连接前,请确保在您的 OKX 账户设置中切换至 单币种保证金 模式。以下是 OKX 官网默认界面的截图:

- 由于 Hummingbot 每次启动时都会设置仓位模式(单向或对冲),若您重启 Hummingbot,请先检查是否存在未平仓头寸。如有,请先平仓。
