Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications

Open on n8n.io

$20/month : Unlimited workflows

2500 executions/month

Try free

THE #1 IN WEB SCRAPING

Scrape any website without limits

Try free

HOSTINGER

Early Deal
DISCOUNT 20%

Self-hosted n8n

Unlimited workflows - from $4.99/mo

Try free

#1 hub for scraping, AI & automation

6000+ actors - $5 credits/mo

Try free

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

Overview This n8n workflow is specifically designed to monitor the USDT ERC 20 balance within a specific wallet. It uses Etherscan's public blockchai...

Best for

Crypto Trading automation workflows
intermediate n8n builders looking for reusable templates

Tools used

n8n-nodes-base.if, n8n-nodes-base.telegram, n8n-nodes-base.set, n8n-nodes-base.code, n8n-nodes-base.stickynote, n8n-nodes-base.cron, n8n-nodes-base.httprequest

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by FORK SOFTWARE TECHNOLOGIES INC..

Original n8n.io source

1.1 Workflow description

Title: Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications
Workflow name: Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications

Overview

This n8n workflow is specifically designed to monitor the USDT ERC-20 balance within a specific wallet. It uses Etherscan's public blockchain database, which does not require API authentication, to periodically check and process transaction data. This workflow is ideal for users who need an automated solution to track ERC-20 wallet transactions.

Features

Automatic Monitoring: Executes every 5 minutes to capture new transactions.
Customizable Filters: Customize tracking based on parameters like transaction duration and wallet addresses.
Data Aggregation: Compiles transaction data into a single, structured list.
Formatted Outputs: Presents processed data in an organized format.
Telegram Tracking: Tracks wallet balances via Telegram notifications using the bot.

Requirements

n8n Setup: Requires a self-hosted or cloud-based n8n instance.
Basic Understanding: Basic knowledge of n8n workflows and nodes.

Installation and Configuration

Import Workflow: Load the provided JSON workflow into your n8n instance.
Configure the User Data Node:
- Enter your ERC-20 Wallet Address in the 'Your Wallet Address' field.
- Enter your Etherscan API Key in the “Your Etherscan API Key” field.
- Enter your USDT ERC-20 Contract Address in the "Your ERC-20 USDT Contract Address" field (0xdAC17F958D2ee523a2206206994597C13D831ec7). You can also monitor another token by entering a different contract address.
Configure the Telegram Node:
- Go to Telegram and search for "BotFather".
- Select /newbot from the BotFather menu to create your bot.
- Get the API key BotFather provides.
- Go to Telegram and search for "Get My ChatID".
- Start the conversation and get your ChatID.
- Use this information to configure the Telegram Node.
Schedule Trigger Node: By default, the workflow is triggered every 5 minutes. Adjust this according to your needs.
Test the Workflow: Execute the workflow manually to ensure everything is working as expected.

How It Works

Schedule Trigger: Starts the workflow at predetermined intervals.
Edit Fields: Sets the wallet address, Etherscan API key, and USDT ERC-20 token address.
Edit Telegram Settings: Create a bot via BotFather. Configure the API key and Telegram Chat ID.
Etherscan Data Import: Collects transaction data from the ERC-20 wallet using Etherscan's public database.
Final Results: Organizes and formats the transaction data for review.
Telegram Bot Message Sending: If there is a balance change, it sends a formatted message about the balance change. If there is no balance change, it sends a message that your balance has not changed. You can configure it to avoid sending a message when there is no change.

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - Balance Changed?

Type / Role: n8n-nodes-base.if - if
Config choices: Version 1

Block 2 - Balance Changed.

Type / Role: n8n-nodes-base.telegram - telegram
Config choices: Version 1

Block 3 - Balance Not Changed.

Type / Role: n8n-nodes-base.telegram - telegram
Config choices: Version 1

Block 4 - userData

Type / Role: n8n-nodes-base.set - set
Config choices: Version 3.4

Block 5 - balanceChecker

Type / Role: n8n-nodes-base.code - code
Config choices: Version 2

Block 6 - Sticky Note

Type / Role: n8n-nodes-base.stickyNote - stickyNote
Config choices: Version 1

Block 7 - Check Balance Every 5 Minutes

Type / Role: n8n-nodes-base.cron - cron
Config choices: Version 1

Block 8 - Fetch USDT Balance from Etherscan

Type / Role: n8n-nodes-base.httpRequest - httpRequest
Config choices: Version 3

3. Summary Table

Workflow	Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications
Complexity	intermediate
Nodes	8
Categories	Crypto Trading
Author	FORK SOFTWARE TECHNOLOGIES INC.
Published	26 Mar 2025

4. Reproducing the Workflow from Scratch

1. Download the workflow JSON

Use the JSON export at /data/workflows/3330/3330.json as the source template for this automation.
2. Import the template into n8n

Open n8n, import the downloaded JSON, and review each node before activating the workflow.
3. Configure credentials and variables

Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.
4. Test with sample data

Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.
5. Activate and monitor

Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Download workflow JSON Original n8n.io source Crypto Trading workflows

Frequently asked questions

What does Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications do?

Overview This n8n workflow is specifically designed to monitor the USDT ERC 20 balance within a specific wallet. It uses Etherscan's public blockchai...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Crypto Trading use case.

FORK SOFTWARE TECHNOLOGIES INC.

2 workflows

Nodes

n8n-nodes-base.if n8n-nodes-base.telegram n8n-nodes-base.set n8n-nodes-base.code n8n-nodes-base.stickynote n8n-nodes-base.cron n8n-nodes-base.httprequest

Complexity

intermediate

Published 26 Mar 2025

Likes 0

View on n8n.io Download Workflow

Install path: /data/workflows/3330/3330.json

Share Your Workflow

Have a useful automation to share? Publish it and help the community.

Submit Your Template How to Submit

Related Workflows

Send portfolio risk reports with Google Sheets, GPT-4o-mini and Gmail

## Quick Overview This workflow receives a portfolio via webhook (uploaded CSV or Google Sheets), calculates allocation and concentration risk metrics, generates an OpenAI HTML risk report, emails it through Gmail, and returns a JSON API response with the report status. ## How it works 1. Receives a POST webhook request containing a portfolio source type plus user name and email. 2. Loads holdings either by decoding an uploaded base64 CSV into rows or by reading rows from Google Sheets. 3. Combines all holdings into a single dataset and attaches user and source metadata. 4. Calculates portfolio totals, position weights, sector and asset-class breakdowns, concentration flags, top gainers/losers, and an overall risk score and label. 5. If the portfolio is valid, sends the computed metrics to OpenAI to generate a client-ready HTML risk narrative. 6. Builds a formatted HTML email that includes the AI analysis plus sector and top-holdings tables, then sends it to the user via Gmail and returns a success JSON response. 7. If the portfolio is empty or invalid, emails a failure notice via Gmail (when an email is provided) and returns a 422 JSON error response. ## Setup 1. Create and connect credentials for Google Sheets OAuth2, OpenAI, and Gmail OAuth2. 2. Configure the webhook endpoint by copying the production URL and sending POST requests to the /portfolio-analyze path. 3. For CSV submissions, include base64 CSV content in body.fileData (or body.csvBase64/body.file) and ensure the columns include ticker, company, sector, quantity, avg_buy_price, current_price, and asset_class. 4. For Google Sheets submissions, update the spreadsheet document ID and sheet (gid) to the holdings table you want to analyze. 5. Ensure the request includes userEmail (body, query, or x-user-email header) so the workflow can deliver the report or validation error message.

View

Analyze commodity portfolio diversification with Sheets, Gemini, and Gmail

## Quick Overview This workflow reads a gold/silver/oil portfolio from Google Sheets, pulls current commodity prices and a recent gold trend from GoldAPI, EIA, and Twelve Data, calculates allocation and HHI concentration risk, generates a Gemini analysis, and emails an HTML diversification report via Gmail. ## How it works 1. Starts manually and loads configuration values, then reads your portfolio holdings from Google Sheets. 2. Fetches real-time gold and silver prices in INR from GoldAPI, retrieves crude oil prices in USD from the EIA API, and converts oil prices to INR. 3. Pulls the last two daily closes for GLD from Twelve Data and compares them to label the gold market trend as UP or DOWN. 4. Aggregates the latest commodity prices and trend data, then calculates portfolio allocation percentages and an HHI concentration score from the Google Sheets holdings. 5. Sends the allocation, HHI score, and gold trend to Google Gemini to generate a structured risk assessment, rebalancing recommendations, trend impact, and a verdict. 6. Parses Gemini’s response into dedicated fields, builds a formatted HTML report with prices, allocations, risks, recommendations, and verdict, and sends it to the configured recipient via Gmail. ## Setup 1. Add API keys for GoldAPI, the U.S. EIA API, and Twelve Data in the configuration step (and confirm the USD-to-INR conversion rate is correct for your needs). 2. Connect your Google Sheets account, then update the spreadsheet and sheet tab to a portfolio table that includes commodity_name and buy_price for gold, silver, and oil. 3. Connect your Google Gemini (PaLM) API credential and ensure the selected model is available in your account. 4. Connect your Gmail OAuth2 credential and set the recipient email address used for the report delivery.

View

Log gold and silver prices and email Groq insights with Google Sheets

## Quick Overview This workflow manually logs daily Gold and Silver prices from GoldAPI into Google Sheets, summarizes historical monthly averages, generates seasonal insights with Groq (LLM), builds QuickChart bar charts, and emails a formatted report via Gmail. ## How it works 1. Starts manually and loads a two-item asset list (Gold/XAU and Silver/XAG) to process in a loop. 2. For each commodity, calls the GoldAPI endpoint to fetch the latest INR price and converts it into a per-10g value with date and month fields. 3. Checks Google Sheets for an existing row for the same commodity and date, keeps the higher of the two prices, and appends or updates the row in the historical sheet. 4. Reads the full historical dataset from Google Sheets and calculates monthly average, minimum, and maximum prices grouped by month and commodity. 5. Formats the monthly averages into a text block and sends it to a Groq-hosted chat model to generate a structured JSON insight summary for gold, silver, and the overall trend. 6. Creates QuickChart URLs for separate Gold and Silver monthly-average bar charts and emails the AI summary and chart images using Gmail. ## Setup 1. Add a GoldAPI key and set it in the HTTP request header (x-access-token) for the GoldAPI call. 2. Connect Google Sheets OAuth credentials and select the target spreadsheet and sheet tab where rows are stored (e.g., the 04_HistoricalData sheet). 3. Ensure the sheet has columns for ID, Date, Month, Price, and Commodity, and that ID is used as the upsert/matching key. 4. Add Groq API credentials for the Groq chat model used to generate the JSON insights. 5. Connect Gmail OAuth credentials and replace the placeholder recipient address ("RECEIVER MAIL ID") and subject as needed.

View

Need Custom Automation?

Get help designing a custom n8n workflow that connects your stack and fits your process.

Monitor USDT ERC-20 wallet balance with Etherscan and Telegram notifications

Workflow preview

Important notice

1. Workflow Overview

Best for

Tools used

Source and attribution

1.1 Workflow description

Overview

Features

Requirements

Installation and Configuration

How It Works

1.2 Logical Blocks

2. Block-by-Block Analysis

Block 1 - Balance Changed?

Block 2 - Balance Changed.

Block 3 - Balance Not Changed.

Block 4 - userData

Block 5 - balanceChecker

Block 6 - Sticky Note

Block 7 - Check Balance Every 5 Minutes

Block 8 - Fetch USDT Balance from Etherscan

3. Summary Table

4. Reproducing the Workflow from Scratch

1. Download the workflow JSON

2. Import the template into n8n

3. Configure credentials and variables

4. Test with sample data

5. Activate and monitor

5. General Notes & Resources

Frequently asked questions