Hanzo: AI Trading Journal & Performance Tracker Agent

Description

Hanzo — AI Trading Journal & Performance Tracker Agent (n8n Workflow + Telegram + Gemini)

Log trades instantly through Telegram and track your performance automatically in Google Sheets.

📌 What Hanzo Does

Hanzo is your automated trading journal. Just send a trade message through Telegram, and Hanzo logs it into Google Sheets with date, pair, direction, entry, stop loss, take profit, and notes—all formatted into clean columns.

✅ Logs trades into Google Sheets automatically
✅ Stores pair/asset, entry, SL, TP, P/L, win/loss, notes, and timestamp
✅ Works through simple Telegram messages
✅ No manual journaling or typing into spreadsheets
✅ Optional screenshot/photo upload support for visual journals

Never forget trades. Never lose performance history. Everything gets captured.

🔥 Why It’s Useful

⏱ Log trades in seconds — even while on mobile
📊 Gain performance awareness with clean tracking
✅ Track win rate, R:R, and real long-term progress
📈 Helps build discipline and review your strategy objectively
📱 Works entirely through Telegram — zero extra apps

Every pro trader journals. Hanzo makes it effortless.

🚀 How It Works

Telegram Bot receives messages such as:
/trade EURUSD buy @1.08250 SL 1.08000 TP 1.08700

Hanzo automatically:
✅ Parses the message using Gemini AI
✅ Extracts pair, direction, entry price, SL, TP, notes, timestamp
✅ Appends a new row into Google Sheets
✅ Categorizes trade as long/short and stores values cleanly
✅ Keeps your trading journal structured and review-friendly

✅ What You Need

✅ Telegram Bot token (via @BotFather)
✅ Your Telegram Chat ID
✅ Google OAuth credentials for Sheets
✅ A Google Sheet with trade journal columns

🔧 Setup Steps

Create a Telegram bot via @BotFather and copy the token

Get your Chat ID using the getUpdates method

Make a copy of the included Google Sheets journal template

Add your Chat ID and Sheet ID inside the workflow

Send a test message like:
/trade BTCUSD buy 42150 SL 42000 TP 42500

No coding required — plug in your credentials and start journaling.

🧩 Optional Upgrades (Customizable in n8n)

📈 Add P/L calculation automatically
📉 Track win rate and R:R over time
📊 Build dashboards with Data Studio / Looker
📬 Send weekly or daily trading summaries
📷 Add screenshot/photo support for trade analysis
🧠 Add tags: breakout, reversal, news trade, scalp, swing

👤 Who It’s For

✅ Forex, Crypto, and Stock traders
✅ Anyone who wants disciplined trade journaling
✅ Traders learning from mistakes and patterns
✅ Those who review their statistics and refine strategy
✅ Perfect for journaling on mobile while trading

📦 What You Get

✅ Complete Hanzo n8n workflow
✅ Google Sheets journal template
✅ Telegram command examples
✅ Setup guide
✅ Lifetime access to updates