Real-Time Bybit Crypto Market Data Agent via Telegram - n8n Workflow

• Crypto traders and analysts who require immediate, reliable data from Bybit.


• Developers looking for advanced n8n templates integrating external APIs with AI agents.


• Users who need a secure, authenticated crypto reporting tool delivered via Telegram.


• Anyone seeking to deploy a sophisticated n8n workflow for market monitoring.

This complex n8n workflow addresses the need for instant, structured access to financial data without manual querying or complex charting software. It leverages the power of an AI Agent running within n8n to interpret natural language commands sent through Telegram, decide which Bybit API calls are necessary, execute those requests, and then present the aggregated results in a clean, human-readable format.

The key value of this specific n8n workflow lies in its strict separation of duties: the Bybit AI Agent n8n node is configured only to fetch and format data, ensuring the output is objective market facts (prices, volumes, order book depth) rather than speculative analysis. This is a robust n8n templates solution for institutional or power users who demand accuracy and speed, starting immediately when the Telegram n8n trigger fires.

The entire process is initiated by the Telegram Trigger n8n node, which listens for incoming messages.

1. Trigger & Security: An incoming message activates the Telegram Trigger n8n node. The workflow immediately passes the data to a Code n8n node (User Authentication) to verify that the sender's Telegram ID is authorized. If the ID is approved, a Set n8n node assigns essential metadata like the sessionId (chat ID) and the raw user message.


2. AI Orchestration: The data moves to the Bybit AI Agent n8n node. This agent uses the OpenAI Chat Model (specifically gpt-4.1-mini) for reasoning and coordination, and the Simple Memory n8n node to maintain context across multi-turn queries.


3. Tool Execution: Based on the user's input (e.g., "What is the price of BTCUSDT?"), the AI Agent selects and executes one or more specialized n8n httpRequestTool nodes. These tools hit the Bybit v5 Spot API endpoints to retrieve prices, 24h stats, order book depth, or Klines.


4. Formatting & Utility: The Calculator n8n node performs any necessary math (like calculating midpoints), and the Think n8n node processes and formats the raw JSON results into the structured HTML defined in the Agent's system prompt.


5. Output Handling: The resulting report is sent to a final Code n8n node (Splits message is more than 4000 characters). This preventative measure ensures that if the report exceeds Telegram's 4096-character limit, the output is automatically split into manageable chunks.


6. Delivery: The final report is delivered back to the user via the final Telegram n8n node.

To deploy this comprehensive n8n workflow, follow these steps:

1. Import the n8n workflow: Copy the provided JSON data and paste it into your n8n instance using the 'Import Workflow' function.


2. Telegram Setup: Create a new Telegram Bot via BotFather. Set up credentials for the Telegram Trigger and the final Telegram n8n node using your Bot Token.


3. OpenAI Credentials: Set up your OpenAI API key credentials for the OpenAI Chat Model n8n node.


4. User Authentication: Update the User Authentication (Replace Telegram ID) n8n node's Code to include your actual authorized Telegram user ID in place of <>. This is crucial for security.


5. Activate: Ensure the n8n trigger is set to 'Active' to start listening for commands. Send a test message to your bot to verify the n8n workflow is functioning.

Telegram Trigger (n8n trigger): The starting point of the n8n workflow, listening for messages (updates) sent to the configured Telegram bot.
User Authentication (Code n8n node): Implements a security layer by checking message.from.id against a hardcoded authorized user ID, preventing unauthorized access to the Bybit agent.
Adds "SessionId" (Set n8n node): Creates and passes essential workflow context, including the chat ID as sessionId and the user's message as message, into the AI Agent for continuity.
OpenAI Chat Model (Language Model n8n node): The core large language model, configured to use gpt-4.1-mini. It provides the reasoning capability for the Bybit AI Agent.
Simple Memory (Memory n8n node): Stores short-term conversation context, allowing the AI Agent to remember previous market symbols requested.
Bybit AI Agent (Agent n8n node): The central orchestrator. It uses the input, memory, and LLM to determine the appropriate Bybit API calls (Tools) required to fulfill the user's data request.
HTTP Request Tools (e.g., 24h Stats, Klines): These are specialized httpRequestTool n8n nodes integrated into the Agent. They connect directly to the Bybit v5 API endpoints (e.g., /v5/market/tickers, /v5/market/kline) to fetch raw data.
Splits message... (Code n8n node): A utility n8n node that prevents message failure by splitting the AI Agent's potentially long output into chunks smaller than the Telegram limit (4000 characters).

• Telegram (n8n node): The final action, responsible for sending the fully formatted crypto market data report back to the initiating user.