🔥 Kucoin
基金会合作伙伴
Kucoin 是 Hummingbot 基金会的 交易所合作伙伴,因此当你使用 Hummingbot 在 Kucoin 上运行交易机器人时,部分手续费将用于支持基金会及其通过开源软件普及算法交易的使命。为帮助我们,可通过我们的 Kucoin 推荐链接 创建账户,并将该账户的 API 密钥输入 Hummingbot 启动机器人!感谢你的支持!🙏
🛠 连接器信息¶
- 交易所类型:中心化交易所 (CEX)
- 市场类型:限价订单簿 (CLOB)
| 组件 | 状态 | 连接器版本 | V2 策略 | 备注 | 
|---|---|---|---|---|
| 🔀 现货连接器 | ✅ | v2.1 | 是 | 支持 MARKET订单类型 | 
| 🔀 永续合约连接器 | ✅ | v2.1 | 是 | 支持测试网 | 
| 🕯 现货 K 线数据流 | ✅ | |||
| 🕯 永续合约 K 线数据流 | ✅ | 
ℹ️ 交易所信息¶
- 官网:https://www.kucoin.com
- CoinMarketCap:https://coinmarketcap.com/exchanges/kucoin/
- CoinGecko:https://www.coingecko.com/en/exchanges/kucoin
- API 文档:https://docs.kucoin.com
- 手续费:https://www.kucoin.com/vip/level
- 支持国家:https://www.kucoin.com/support/10247584234521
- Kucoin 推荐链接: https://www.kucoin.com/r/af/hummingbot
🔑 如何连接¶
生成 API 密钥¶
步骤 1
登录 Kucoin,点击头像,在下拉菜单中选择 API 管理 > 创建 API。

步骤 2
将弹出一个窗口,你可以选择 API 交易 或 链接第三方应用。
如用于 API 交易,请输入 API 名称和 API 密码。

如用于链接第三方应用,首先选择你希望链接的第三方应用名称,然后输入 API 名称和 API 密码,并选择 API 权限。
出于账户安全考虑,通过链接第三方应用无法支持提币,也无需绑定 IP 地址。交易过程中,平台将使用你配置的第三方 IP 地址。

创建过程中,请留意 API 创建页面上的相关提示与规则,以下几点需特别注意:
- 
API 密码至关重要,强烈建议将其记录并安全保存。使用 API 时需要该密码进行验证。同时,请勿泄露你的 API 密钥,以防资产损失。 
- 
为保障资金安全,启用现货、杠杆或合约交易权限但未绑定 IP 地址的 API 密钥,若在 30 天内无任何活动,将被自动删除或交易权限将被禁用。但仅具有“通用”权限的 API 密钥无过期限制。 
- 
要启用权限访问,必须将你的 IP 地址添加至白名单。 
步骤 3
将弹出安全验证窗口,请输入你的交易密码、邮箱验证码和 Google 验证码。
步骤 4
点击确认按钮完成创建。


将密钥添加到 Hummingbot¶
在 Hummingbot 客户端内运行 connect kucoin:
>>> connect kucoin
Enter your kucoin API key >>>
Enter your kucoin secret key >>>
Enter your kucoin passphrase >>>
若连接成功:
🔀 现货连接器¶
对接现货市场 API 接口
- ID:kucoin
- 连接类型:WebSocket
- Github 文件夹
订单类型¶
此连接器支持以下 OrderType 常量:
- LIMIT
- LIMIT_MAKER
- MARKET
模拟交易¶
通过运行 connect kucoin_paper_trade(而非 connect kucoin)可访问该连接器的 模拟交易 版本。
如果默认不可用,您可以配置 Hummingbot 以添加此模拟交易交易所。更多信息请参见添加交易所。
🔀 永续合约连接器¶
集成至永续期货市场 API 端点
- ID:kucoin_perpetual
- 连接类型:WebSocket
- Github 文件夹
订单类型¶
此连接器支持以下 OrderType 常量:
- LIMIT
- LIMIT_MAKER
- MARKET
仓位模式¶
此连接器支持以下仓位模式:
- 单向
- 对冲
模拟交易¶
该永续合约交易所提供模拟交易模式:https://www.kucoin.com/support/7909075578521
创建账户并生成 API 密钥后,你可在 Hummingbot 客户端中使用 connect kucoin_perpetual_testnet 命令输入密钥。连接成功后,即可使用可用的永续合约策略/脚本在测试网上进行交易。
🕯 现货 K 线数据源¶
从该交易所的现货市场收集历史 OHCLV 数据
- ID:kucoin
- 支持的时间间隔:1 分钟 | 3 分钟 | 5 分钟 | 15 分钟 | 30 分钟 | 1 小时 | 2 小时 | 4 小时 | 6 小时 | 8 小时 | 12 小时 | 1 天 | 1 周
- Github 文件夹
使用方法¶
在 Hummingbot 脚本中,导入 CandlesFactory 以创建所需的 K 线数据:
    from hummingbot.data_feed.candles_feed.candles_factory import CandlesFactory
    candles = CandlesFactory.get_candle(connector="kucoin",
                                        trading_pair="ETH-USDT",
                                        interval="1m", max_records=50)
更多详情请参见candles_example.py。
🕯 永续合约 K 线数据源¶
永续合约不提供 K 线数据流
