添加 TradingView 警报工具 🤖

自动批量将自定义警报添加到 TradingView

⚠️ 警告：在您的计算机上运行命令行软件存在风险！尽管此软件中没有已知的恶意代码——但它依赖于__可能容易受到黑客攻击的第三方库__。截至 2021 年底，针对第三方库的黑客攻击事件有所增加——请自行承担风险使用。

👋 注：我们提供一项服务，可在安全的虚拟服务器上自动运行此工具。您可前往 alertzmanager.io 成为测试用户。

项目背景

交易平台（如 3Commas 和 Alertatron）允许基于自定义 TradingView 警报进行自动化交易，这些警报可以通过 Webhook URL 触发以执行交易。

当使用 TradingView 指标（如 Material Indicators）时，您可以利用 TradingView 警报向您的交易机器人发送信号。

那么，如果您想使用某个指标来交易数十甚至数百个交易对，该怎么办呢？由于 TradingView 没有用于批量添加警报的 API，您需要手动维护这些警报。

该工具如何工作？

我们使用专为自动化网站测试设计的开源软件，可以输入您 TradingView 账户允许的任意数量的自定义警报。它会安装一个独立的 Chrome 浏览器（称为 Chromium），并由本脚本控制。

观看该工具如何自动输入您的 TradingView 警报。

系统要求

MacOS/Windows/Linux

安装 NodeJS（推荐版本：22.x）

安装

打开终端或 PowerShell，并运行以下命令：

请确保您使用的 Node 版本至少为 22

node -v

创建您的 tradingview-alerts-home 目录，或升级版本 (系统会提示您创建子目录并安装 ATAT)

npx @alleyway/create-tradingview-alerts-home@latest

编辑您的 config.yml 文件（如果您要传递用于自动化交易的信号，例如 3commas，请在此处配置相关详细信息）

files:
  input: binance_usdt_symbols.csv
  exclude: blacklist.csv
tradingview:
  # 您希望使用的带有指标的图表
  chartUrl: https://www.tradingview.com/chart/WS5uK1l5/
  # (可选) 在添加交易对之前设置图表时间周期，否则将使用上次保存图表的时间周期
  # 示例：1s | 30s | 1m | 15m | 1H | 1D | 1W      # 注意：'1H,4H' 可用于在多个时间周期上添加警报
  interval: 4h
  # 您可以选择提供登录凭据，或者先手动登录一次后再重启脚本
  #username: 
  #password: 
alert:
  condition:
    primaryLeft: MTF Deviation
    primaryRight:
    secondary: Tier1 long
    tertiaryLeft:
    tertiaryRight:
    quaternaryLeft: 
    quaternaryRight:
  trigger: 每根柱线收盘触发一次
  actions:
    notifyOnApp: false
    showPopup: false
    sendEmail: false
    webhook:
      enabled: true
      url: "https://3commas.io/trade_signal/trading_view"
  # 警报名称是可选的——如果需要，可以在 CSV 文件中覆盖，并使用 {{symbol|instrument|quote_asset}}
  # name: MI dev3 for {{instrument}} {{quote_asset}}
  # 缩进很重要！{{quote_asset}} 和 {{instrument}} 将被替换为报价资产（例如 USDT）和基础代币或标的资产（例如 'BTC'）
  message: >
    {
        "message_type": "bot",
        "bot_id": 999999,
        "email_token": "fffffff-fffff-fffff-ffff-ffffffffff",
        "delay_seconds": 0,
        "pair": "{{quote_asset}}_{{instrument}}"
    }

<img src=".README_images/howto_conditions.png" alt="与配置对应的字段" width="600"/

获取交易对列表

生成可用于输入的 CSV 文件（参见上述配置），适用于支持的交易所。想要其他交易所吗？提交一个问题！)

从 Binance/BinanceUS 下载交易对

此命令下载 Binance 的所有 USDT 交易对：（注意：Binance 现在对其部分接口进行了地理限制）

    ./atat fetch-symbols binance -q usdt        

此命令下载 BinanceUS 的所有交易对：

    ./atat fetch-symbols binanceus

从 Coinbase 下载交易对

    ./atat fetch-symbols coinbase -q usd

从 Kraken 下载交易对

    ./atat fetch-symbols kraken -q usd

从 KuCoin 下载交易对

    ./atat fetch-symbols kucoin -q usdt

从 OKX（原 OKEx）下载现货交易对

    ./atat fetch-symbols okx_spot -q usdt

从 ByBit Inverse 下载交易对

    ./atat fetch-symbols bybit_inverse

从 ByBit Linear 下载交易对

    ./atat fetch-symbols bybit_linear

……依此类推。

添加 TradingView 警报

在运行脚本之前

当添加警报时，TradingView 会将您上次的设置作为新警报的默认值。 如果未在 config.yml 文件中明确设置，则将使用上次创建的警报设置。因此，如果您希望开启或关闭声音提醒，请在运行脚本之前先创建一个包含该设置的警报。

您必须先使用这些选项创建一个警报，然后它们才会成为默认设置。（之后您可以立即删除该警报）

运行脚本

注意：首次运行脚本时，您需要登录 TradingView，然后关闭浏览器并重新运行命令。

./atat add-alerts

您可以在终端或 PowerShell 中按 Ctrl-C 停止脚本。

如果工具因故中断，您可以从 .csv 文件中移除已添加警报的交易对行，然后重新运行。

故障排除

• Windows 用户因从互联网下载的文件导致执行出现问题（由用户贡献）

  powershell -executionpolicy ByPass -File .\atat.ps1 fetch-symbols binance -q usdt

• 网络连接速度较慢，操作过快？尝试调整延迟选项（默认值为 1000）

  ./atat --delay 1500 add-alerts

• 是否选择了错误的选项？条件可以是正则表达式。例如……

假设您有一个条件下拉菜单，其中包含多个指标配置，如下所示：

MTF 偏差 - Mtrl_Scientist v0.7 (50, 530, 750, 3)
MTF 偏差 - Mtrl_Scientist v0.7 (50, 530, 750, 6)
MTF 偏差 - Mtrl_Scientist v0.7 (50, 530, 750, 9)

如果您的配置仅使用了“MTF 偏差”这一术语，工具可能会错误地选择第一个包含该术语的选项。

例如，以下正则表达式将匹配百分比偏差设置为 6 的指标：

alert:
  condition:
    primaryLeft: /^MTF Deviation.*,\s6\)$/

另一个常见问题是，有时一个条件的选项文本可能完全包含在另一个选项中。

例如：

蓝波向下交叉 [小红点]
蓝波向上交叉 [小绿点]
小绿点

要精确匹配“小绿点”的正则表达式如下：

alert:
  condition:
    primaryLeft: /^小绿点$/

❓了解更多关于正则表达式语法的信息

• 找不到“atat”命令？请从您的 tradingview-alerts-home 目录运行以下命令：

  npx @alleyway/create-tradingview-alerts-home@latest

• 还有其他问题吗？提交问题

高级用法

多重配置

针对以 BTC 计价资产配置的 TradingView 指标可能不适用于 USD 交易对，因此您需要按以下方式划分设置：

抽象	具体
仅以 BTC 计价的交易对列表	运行 "./atat fetch-symbols binance btc" 输入：binance_usdt_symbols.csv
包含针对 BTC 特定指标设置的 TradingView 图表布局（例如，将 MTF 偏差的偏差设置为 6%）	chartUrl: https://www.tradingview.com/chart/WS5uK1l5/
仅处理 BTC 的 3commas 交易机器人	{ "message_type": "bot", "bot_id": 999999, "email_token": "fffffff-fffff-fffff-ffff-ffffffffff", "delay_seconds": 0, "pair": "{{quote_asset}}_{{instrument}}" }
上述内容的专用配置文件	./atat add-alerts config.btc.yml

注意：运行“./atat add-alerts”将默认使用 config.yml，除非您指定其他配置文件（例如，“./atat add-alerts config.btc.yml”）。

警报设置中的占位符替换

在某些情况下，您可能希望某些交易对使用不同的指标，或者使用相同指标但设置不同（必须为每种设置添加到图表中——目前此脚本尚无法调整指标设置）。

然后您可以向您的 .csv 文件添加任意列——这里我们使用“DSMAsetting”。

symbol,quote_asset,instrument,DSMAsetting
BINANCE:1INCHUSDT,USDT,1INCH,40
BINANCE:AAVEUSDT,USDT,AAVE,20
BINANCE:ACMUSDT,USDT,ACM,40
BINANCE:ADAUSDT,USDT,ADA,20

随后，您可以通过将列标题名用双大括号括起来来使用 CSV 中的任何值，如下所示：

...
alert:
  condition:
    primaryLeft: "DSMA ({{DSMAsetting}}, 50)"
...

向多个 3commas 机器人发送单个警报

3commas 允许您在消息中使用命令数组，我通常会向两个机器人发送消息：一个用于模拟交易，另一个是真实的账户，我可以选择将其禁用。

因此，您可以使用 JSON 数组作为消息：

  message: >
    [{
        "message_type": "bot",
        "bot_id": 999999,
        "email_token": "fffffff-fffff-fffff-ffff-ffffffffff",
        "delay_seconds": 0,
        "pair": "{{quote_asset}}_{{instrument}}"
    },
    {
        "message_type": "bot",
        "bot_id": 999999,
        "email_token": "fffffff-fffff-fffff-ffff-ffffffffff",
        "delay_seconds": 0,
        "pair": "{{quote_asset}}_{{instrument}}"
    }]

向 Alertatron 发送警报

这与 3Commas 的方式相同，但 Alertatron 使用不同的消息格式。例如……

  message: >
    binanceKeys({{quote_asset}}_{{instrument}}) {
        market(side=buy, amount=50%);
        stopOrder(side=sell, amount=100%p, offset=2%);
        limit(side=sell, amount=100%p, offset=3%);
    }

您觉得这个工具有帮助吗？

请考虑以下其中一项：

1. 在 GitHub 上提高知名度：点击页面顶部的 ⭐！

2. 成为我们未来商业服务的 免费 测试员（限时）：

• 图形界面： 无需安装——警报由我们的安全私有服务器添加
• 每个交易对可设置多个警报： 分开买入和卖出警报
• 更快的警报管理： 智能地保留、更新、添加或移除警报
• 灵活的警报模板分配： 利用 24 小时交易所数据（成交量、交易次数）启用或禁用警报
• 自动化： 按计划配置并同步警报，获取新的交易所代币

在 https://alertzmanager.io 创建免费账户

Add TradingView Alerts Tool 快速上手指南

本工具用于在 TradingView 上批量自动添加自定义警报，特别适用于需要基于指标对数十甚至数百个交易对进行自动化交易的场景（如配合 3Commas 或 Alertatron）。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：macOS、Windows 或 Linux。
• Node.js：必须安装 Node.js，推荐版本为 22.x。
  • 检查版本命令：node -v
  • 如果未安装或版本过低，请访问 Node.js 官网 下载并安装。
• 网络环境：由于工具需要控制浏览器访问 TradingView 国际站，请确保网络连接稳定且能正常访问 tradingview.com。

安装步骤

打开终端（Terminal）或 PowerShell，按顺序执行以下命令：

1. 创建项目目录并安装工具 运行以下命令将创建名为 tradingview-alerts-home 的目录，并在其中初始化工具（ATAT）：

   npx @alleyway/create-tradingview-alerts-home@latest
   

   注：根据提示确认创建子目录并完成安装。

2. 进入项目目录

   cd tradingview-alerts-home
   

3. 获取交易对列表（可选但推荐） 如果您需要从交易所（如 Binance）获取交易对列表生成 CSV 文件，可运行：

   ./atat fetch-symbols binance -q usdt
   

   这将生成 binance_usdt_symbols.csv 文件供后续使用。支持 binance, binanceus, coinbase, kraken, kucoin, okx_spot, bybit_inverse, bybit_linear 等。

基本使用

1. 配置参数

编辑生成的 config.yml 文件，填入您的 TradingView 图表链接、警报条件及 Webhook 信息。

关键配置项示例：

files:
  input: binance_usdt_symbols.csv  # 输入的交易对 CSV 文件
  exclude: blacklist.csv           # 需要排除的交易对列表（可选）
tradingview:
  chartUrl: https://www.tradingview.com/chart/YOUR_CHART_ID/ # 包含所需指标的图表链接
  interval: 4h                     # 时间周期 (如 1m, 15m, 1H, 4H, 1D)
alert:
  condition:
    primaryLeft: MTF Deviation     # 指标条件名称
    secondary: Tier1 long          # 次要条件
  trigger: Once per bar close      # 触发频率
  actions:
    webhook:
      enabled: true
      url: "https://3commas.io/trade_signal/trading_view" # 您的 Webhook 地址
  message: >
    {
        "message_type": "bot",
        "bot_id": 999999,
        "email_token": "YOUR_TOKEN",
        "delay_seconds": 0,
        "pair": "{{quote_asset}}_{{instrument}}"
    }

注意：{{quote_asset}} 和 {{instrument}} 会自动替换为 CSV 中的计价资产（如 USDT）和基础资产（如 BTC）。

2. 首次运行与登录

1. 在终端执行添加警报命令：

   ./atat add-alerts
   

2. 首次运行时：工具会自动启动一个 Chromium 浏览器窗口。
   • 请在弹出的浏览器中手动登录您的 TradingView 账号。
   • 登录成功后，关闭浏览器窗口。
   • 回到终端，重新运行 ./atat add-alerts 命令。
3. 工具将开始自动遍历 CSV 中的交易对，并在您的图表上批量创建警报。

3. 中断与重试

• 停止脚本：在终端按 Ctrl-C 即可停止。
• 断点续传：如果脚本意外中断，请从输入的 CSV 文件中删除已成功添加警报的行，然后重新运行命令即可继续处理剩余部分。

高级提示：多配置文件

如果您需要针对不同资产（如 BTC 本位和 USDT 本位）使用不同的指标参数，可以创建多个配置文件（例如 config.btc.yml），并通过以下命令指定运行：

./atat add-alerts config.btc.yml