TECHNICAL ASSIGNMENT
Cryptocurrency Market and Macro Context Analysis Platform
(Telegram Trader Assistant based on n8n)
⸻
1. Project Goal
Create a modular Telegram trader assistant that operates through n8n, which:
• automatically collects market data
• analyzes the context, structure, and behavior of participants
• identifies market phases, risks, and formations
• provides interpreted information rather than signals
• helps the trader better understand the market and avoid mistakes
⚠️ The project is not:
• a trading bot
• a signal service
• an investment recommendation
⸻
2. General Architecture
Technologies:
• n8n (Cloud or self-hosted)
• Telegram Bot API
• Only free or conditionally free APIs (paid — only by agreement)
Principle:
Each logical block is a separate workflow
Workflow Structure (MANDATORY)
The project must be divided into the following workflows:
⸻
WF_01 — Macro & Global Context
Purpose
Determining the global mode: risk-on / risk-off
Sources
• ForexFactory / Investing / MarketWatch (RSS or API)
• US macro news
Filtering
Only High Impact events:
• CPI / PPI
• NFP
• FOMC
• Interest Rate Decisions
• Fed / Powell speeches
Logic
• comparison of fact with expectations (if possible)
• determining pressure on risk assets
WF_02 — Market Regime Detector
Purpose
Determining the current market regime
Parameters
• Trend / Range
• High / Low volatility
Data
• ATR
• ADX
• Price range
WF_03 — Market Structure
Purpose
Tracking structural changes
Logic
• HH / HL / LH / LL
• BOS (Break of Structure)
• CHoCH (Change of Character)
Notification Conditions
• only on structure change
• ignore internal noise
WF_04 — Liquidity & Liquidations
Purpose
Tracking liquidity hunting
Data
• Equal Highs / Equal Lows
• Clusters of liquidations
• Funding + OI anomalies
WF_05 — Derivatives & Crowd Behavior
Purpose
Assessing overheating and crowd positions
Data
• Funding Rate
• Open Interest
• Long / Short Ratio (if available)
Logic
• notifications only at extreme values
WF_06 — Volume & Distribution
Purpose
Determining phases:
• impulse
• accumulation
• distribution
Data
• Volume spikes
• Volume delta (if available)
• Price vs volume
WF_07 — HTF Divergences
Purpose
Early warnings of loss of momentum
Logic
• HTF (4H / 1D)
• Price vs Volume / OI divergence
WF_08 — Time & Sessions
Purpose
Considering the time factor
Events
• Asia / London / NY sessions
• London–NY overlap
• NYSE open
WF_09 — Narratives & Sector Rotation
Purpose
Tracking market narratives
Data
• Sectors (AI, RWA, L2, Meme, etc.)
• Relative Strength
• Capital flow between sectors
WF_10 — Risk Control & Discipline
Purpose
Protecting the trader from mistakes
Functions
• notification limits
• active events counter
• overload warnings
WF_11 — Daily Market Snapshot
Purpose
Daily market overview
4. Message Format and Style
Requirements:
• concise
• structured
• no hype
• maximum 2–3 emojis