跳转至内容

示例脚本

如何运行脚本

在 Hummingbot 客户端中，使用以下命令运行脚本：

start --script [SCRIPT NAME]

脚本可以创建时带或不带配置文件。要为脚本创建一个配置文件，请执行：

create --script-config [SCRIPT_FILE]

此命令会自动从本地 /scripts 目录中可配置的脚本进行自动补全。系统会提示您指定策略参数，然后保存在 conf/scripts 目录中的 YAML 文件内。要运行脚本，请使用：

start --script [SCRIPT_FILE] --conf [SCRIPT_CONFIG_FILE]

启动脚本

所有以下示例脚本都可以在根目录的 /scripts 文件夹中找到，并且默认可以在 Hummingbot 客户端中运行。

Simple PMM

  • 代码： simple_pmm
  • 作者: cardosofede
  • 发布版本: 可配置 1.25.0 | 1.9.0
  • 描述: 机器人将在交易所的 trading_pair 中围绕 price_source (中间价或最后成交价) 放置两个订单，距离由 ask_spread 和 bid_spread 定义。每隔 order_refresh_time 秒，机器人将取消并重新放置订单。

Simple VWAP

  • 代码: simple_vwap
  • 作者: cardosofede
  • 发布版本: 1.7.0
  • 描述: 此示例让您使用订单簿总成交量的某个百分比直到中间价的差价在市场中创建一个 VWAP。此示例演示了：
    • 如何获取账户余额
    • 如何获取市场的买入价和卖出价
    • 如何编写"实用"策略

Simple XEMM

  • 代码: simple_xemm
  • 作者: fengtality
  • 发布版本: 1.10.0
  • 描述: 跨交易所做市 策略的简化版本，此机器人在做市方交易对上做市，并在吃单方交易对中对任何成交的交易进行对冲。如果价差（做市订单价格与吃单对冲价格之间的差值）低于 min_spread，机器人将刷新订单

AMM 数据源

  • 代码: amm_data_feed_example
  • 作者: fengtality
  • 发布版本: 2.4.0
  • 描述: 演示在 Hummingbot 中使用 AmmGatewayDataFeed 从去中心化交易所（DEX）如 Uniswap (以太坊) 和 Jupiter (Solana) 获取实时价格数据。该脚本为指定的交易对初始化两个 AMM 数据源，并在准备就绪时显示它们的最新价格数据。

AMM 交易

  • 代码: amm_trade_example
  • 作者: fengtality
  • 发布版本: 2.5.0
  • 描述: 使用 Gateway 连接器监控实时 DEX 价格，一旦达到指定的价格阈值则自动执行兑换。该脚本允许用户配置条件（价格高于或低于目标价格）并可在去中心化交易所如 Solana 上的 Jupiter 或以太坊上的 Uniswap 上无缝处理交易执行。

LP 管理仓位

  • 代码: lp_manage_position
  • 作者: fengtality
  • 新增版本: 2.8.0
  • 描述: 通过网关管理 AMM 或 CLMM 池上的流动性头寸。该脚本监控池价格，在达到目标价格时开立头寸，如果价格在指定时间内超出范围则自动平仓。支持传统的 AMM 池和在 Raydium、Uniswap 和 Meteora 等协议上的集中流动性池。

下载订单簿和交易

  • 代码: download_order_book_and_trades
  • 作者: cardosofede
  • 新增版本: 2.3.0
  • 描述: 持续捕获并存储来自选定交易所的指定交易对的实时交易数据和订单簿快照。该策略将数据以 JSON 格式写入每日的.txt文件中，适合用于市场数据分析、回测或使用 Hummingbot 从 Binance 等交易所创建自定义数据集。

钱包对冲示例

  • 代码: wallet_hedge_example
  • 作者: fengtality
  • 发布版本: 2.4.0
  • 描述: 使用WalletTrackerDataFeed监控链上钱包余额，并通过在中心化交易所下市价单自动对冲任何余额变化。该策略适用于在钱包（如 Ethereum Goerli 上的钱包）和 KuCoin 等交易所之间保持中性头寸，当余额变化超过预定义阈值时触发买入/卖出订单。

V2 脚本

这些脚本更复杂，使用 StrategyV2 组件如 Executors 和 Market Data Provider。

V2 控制器加载器

V2 定向 RSI

V2 资金费率套利

  • 代码: v2_funding_rate_arb.py
  • 作者: cardosofede
  • 新增版本: 1.27.0
  • 描述: 该脚本设置交易对、杠杆和连接器的配置，并根据交易所之间的资金费率差异开立市场头寸。该策略持续监控资金费率并在费用后计算潜在盈利能力，相应地创建和管理头寸。它还根据资金费率差异和交易盈利能力评估止盈或止损的条件。该脚本记录和报告其操作和活动套利头寸的状态。

V2 TWAP

其他脚本

其他示例脚本可以在scripts folder的子文件夹中找到：

  • 基础：执行基础操作的脚本（适合初学者脚本开发人员）
  • 社区：Botcamp 参与者创建的策略
  • 网关：使用 Gateway 的脚本
  • 实用工具：获取数据、筛选市场并执行其他功能的脚本

要使脚本在 Hummingbot 内部运行，请将文件复制或移动到根 /scripts 文件夹中。例如：

cp scripts/basic/format_status_example.py scripts