# TTMT Docs > From Signal to Execution The official documentation for Telegram Trading Management Tool. Turn Telegram signals into intelligent MetaTrader execution — automatically. ## Table of Contents ### Getting Started - [Introduction to TTMT](/getting-started/introduction.md): What TTMT is, how it turns Telegram signals into managed MetaTrader trades, and why it is a full trade-management system, not a simple copier. - [Account Setup](/getting-started/account-setup.md): Create your TTMT account and follow the guided onboarding: subscription, MetaTrader, Telegram, channels, symbols, and a quick settings wizard. - [Connecting MetaTrader](/getting-started/connecting-metatrader.md): Connect your MetaTrader 4 or 5 broker account to TTMT — the MetaAPI Cloud default and self-host preview, broker search or server-file upload, credentials, and automatic symbol matching. No VPS needed. - [Connecting Telegram](/getting-started/connecting-telegram.md): How to securely connect your Telegram account to TTMT so it can read trading signals in real time. - [Subscribing to Channels](/getting-started/subscribing-channels.md): How to discover, follow, and configure Telegram signal channels in TTMT, including quality badges and account assignments. - [Setup Wizard](/getting-started/quick-setup-wizard.md): Configure your trading style in three quick choices — lot size, entry style, and take-profit style — with a live trade preview as you pick. - [Your First Trade](/getting-started/first-trade.md): What happens when your first automated trade executes, how to verify it, where to watch it, and what to check if no trade appears. - [Prop-Firm Setup](/getting-started/prop-firm-setup.md): Day-one setup for prop-firm-funded accounts: connect your challenge server, align TTMT's daily-loss halt with your firm's rules, and pick safe starting risk. - [Next Steps](/getting-started/next-steps.md): Where to go after your first trade -- explore channel settings and filters, trade configuration, config profiles, connection providers, safety features, and performance analytics. ### Channels - [Channels Overview](/channels.md): Connect Telegram signal channels to your MetaTrader accounts and automate trade execution with TTMT. - [Channel Library](/channels/channel-library.md): Explore the curated TTMT Channel Library with quality badges, signal pattern classifications, and community performance data. - [Discovering Channels](/channels/channel-discovery.md): Browse the Channel Library, filter by instrument and performance, and read a channel's track record before you enable it. - [Following Channels](/channels/following-channels.md): Enable, pause, and remove channels in the Channel Hub. How the Enabled / Available / Not a Member sections work and what the resume warning means. - [Analyze Your Own Channel](/channels/analyze-your-own-channel.md): Run TTMT's signal-reading AI on any Telegram channel you've joined and self-approve it to trade right away — no waiting on the TTMT team's review queue. - [Execution Modes](/channels/execution-modes.md): Wait for Full Signal vs Trade on First Alert — choose when TTMT acts on a channel's signals and how it handles follow-up messages. - [Channel Settings](/channels/channel-settings.md): Configure each channel from one page: how signals execute, which accounts trade them, message and symbol filters, SL/TP defaults, blocked trading hours, and change history. - [Message Filters](/channels/message-filters.md): Two filters on a channel's Filters tab: a per-account symbol allowlist that limits which instruments trade, and a channel-wide text blacklist that drops messages containing terms you never want acted on. - [Settings Inheritance](/channels/settings-inheritance.md): How TTMT resolves your trading settings — a channel's config profile sits on top of your per-account settings. Two layers, plus how signal SL/TP and blocked schedules fit. - [Performance Tracking](/channels/performance-tracking.md): Analyze per-channel trading performance with P&L charts, win rates, and detailed signal history to optimize your channel selection. ### Accounts - [Accounts Overview](/accounts.md): How TTMT connects to your MetaTrader accounts, the three account types, and how to ramp from demo to live without risking capital. - [Connecting an Account](/accounts/single-account.md): Connect a MetaTrader account to TTMT, read the account card, understand connection health and the Reconnect prompt, and disconnect safely. - [Multi-Account Management](/accounts/multi-account.md): Run demo, live, and prop-firm accounts in TTMT with independent channel assignments, per-account pause, per-account Risk Limits, and the account switcher. - [One Signal, Many Accounts](/accounts/account-broadcasting.md): How a single channel signal fires on every account you've assigned it to, why each account gets its own independent trade, and when not to mirror. - [Symbol Mapping](/accounts/symbol-mapping.md): How TTMT matches a signal's symbol to your broker's instrument, why some brokers need Generate Aliases, and how to fix unmapped symbols. - [Account Details](/accounts/account-details.md): What the Account Details dialog shows — balance and equity, broker information, trading configuration, provider and account state, your symbol list, and how to disconnect. - [Self-Host Providers](/accounts/self-host.md): How TTMT connects to your broker — MetaAPI Cloud versus the self-host Terminal and Client providers in limited preview, their trailing and market-data limits, and the one-way upgrade path for eligible demo accounts. ### Trade Configuration - [Trade Configuration](/trade-config.md): How TTMT turns a signal into trades: your four settings tabs, the open-vs-manage model, and how channel profiles override your defaults. - [Order Setup — How Your Trades Open](/trade-config/order-setup.md): Choose fixed-lot or % of balance position sizing, set your entry strategy, take-profit and stop-loss defaults, signal overrides, and bad-signal protection. - [Active Trade Setup — Managing Open Trades](/trade-config/active-trade-setup.md): Breakeven, trailing stop, take-profit rebalancing, signal updates, and manual-override behavior — the Trade Management settings that protect open trades. - [Per-Asset Overrides — Tune by Asset Class](/trade-config/per-asset-overrides.md): Set a different sizing mode and default stop-loss/take-profit pips for gold, indices, crypto, and forex so one global setting doesn't have to fit every instrument. - [Runners — Letting Positions Ride](/trade-config/runners.md): Runner positions have no fixed take-profit and ride a move until your stop, trailing stop, or a manual close ends it. When to enable Open TP and how to trail. - [Trade Preview — See Settings Before They Trade](/trade-config/trade-preview.md): The Trade Preview panel turns your settings into a sample trade — orders, targets, risk, and retracement scenarios — so you test changes before risking money. - [Loss-Streak Risk Reduction](/trade-config/loss-streak-risk-reduction.md): An experimental, per-channel control that automatically sizes your trades down after consecutive losses and restores them after a win, so a cold streak costs less. ### Config Profiles - [Config Profiles](/config-profiles.md): Config profiles are named settings presets you assign per channel — and per account — to override your account defaults without changing your global setup. - [Creating Config Profiles](/config-profiles/creating-profiles.md): Create a config profile, override only the settings you need, build its blocked-hours schedule, and save it past cross-field validation — a full walkthrough of every setting group you can override. - [Organizing Profiles](/config-profiles/organizing-profiles.md): Group, filter, and sort a growing library of config profiles — and understand why grouping a profile is not the same as assigning it to a channel. - [Applying Config Profiles](/config-profiles/applying-profiles.md): Assign a config profile to a channel — and a different profile per account on broadcast channels — then see exactly how each setting gets decided. - [Profile Strategies](/config-profiles/profile-strategies.md): Ready-to-use config profile recipes — conservative, aggressive, Gold, demo-vs-live, scalping, prop-firm and news-safe — with the exact settings to override. - [Profile Sharing](/config-profiles/profile-sharing.md): Share a tuned config profile as a one-click import link — or import someone else's — and get behaviour-identical settings and schedule, even across different accounts. ### Webhooks - [TradingView Webhook Setup](/webhooks/tradingview-setup.md): Connect TradingView alerts to TTMT and have them trade through the same pipeline as Telegram signals — create a webhook, paste the JSON, verify the connection, and map your symbols. ### Core Concepts - [Core Concepts](/core-concepts.md): Deep dive into how TTMT works — signal processing, order execution, TP redistribution, breakeven management, and risk controls. - [How TTMT Reads Your Signals](/core-concepts/signal-processing.md): How TTMT reads Telegram messages, filters unwanted ones, cleans up bad prices, skips a closed market, decides what to trade per account, and what each signal status means. - [Order Execution Strategy](/core-concepts/order-execution.md): How TTMT splits each signal into layered entries — you choose 1–6 layers and the engine works out how many orders each needs from your lot size and broker rules, up to 36 total. - [Order Management](/core-concepts/order-management.md): The deep reference for a TTMT trade's full life — volume sizing, how layers become orders, entry zones, target assignment, fills, target shifting, close actions, and end reasons. - [Limit Order Conversion](/core-concepts/limit-order-conversion.md): How TTMT turns a waiting limit order into a market order when a followup confirms price is now inside the provider's entry zone, without chasing price. - [How Your Entry Zone Is Decided](/core-concepts/entry-zone-resolution.md): TTMT combines a signal's stated entry zone with your settings to decide the exact price band your trade enters across. Here are the five outcomes. - [Entry Zone Expansion](/core-concepts/entry-zone-expansion.md): Catch near-miss entries by widening your entry zone 1-20 pips toward your take-profits — without adding risk on the deep side of the trade. - [Override Modes](/core-concepts/override-modes.md): When and how TTMT replaces a signal's entry zone, stop-loss, or take-profits with your own values — and the difference between fixed and dynamic. - [TP Redistribution](/core-concepts/tp-redistribution.md): How TTMT shifts your take-profit targets closer as deeper layers fill — securing profit faster when exposure grows, while a runner holds the full move. - [Breakeven Management](/core-concepts/breakeven-management.md): How TTMT moves your stop to entry once a trade profits — the five ways breakeven fires, the fallback when it can't, and how trailing stops work (and which providers support them). - [Risk Management](/core-concepts/risk-management.md): How TTMT protects your capital — sizing that ignores signal lot sizes, the total-volume safety ceiling, stop-loss safety checks, the per-trade P&L cap, the concurrent kill switch, and advisory drawdown guidance. ### Oracle - [Oracle](/oracle.md): Oracle is TTMT's trade-quality gate — it grades each trade before it runs, tells you when a setup looks weak, and can optionally hold the worst ones back. - [Oracle Modes & Strictness](/oracle/modes-and-strictness.md): How to configure Oracle — pick a mode (off, advisory, or guardian), set how strict it is, choose how it treats price relative to the entry zone, and override any of it per profile. - [Reading Oracle](/oracle/reading-oracle.md): Where Oracle shows up across TTMT — dashboard, trade log, trade modal, replay, performance, and profiles — and how to read its verdicts and the savings it reports. ### Safety & Reliability - [Safety & Reliability Overview](/safety-and-reliability.md): How TTMT protects your capital with five layers of defense, from signal validation to emergency controls. A safety system that also executes trades. - [Signal Validation](/safety-and-reliability/signal-validation.md): The order TTMT applies to every signal — text blacklist, market-state check, parse, then stop-loss, take-profit, entry-zone, duplicate, and pre-trade validation before placing an order. - [Signal Sanitizer](/safety-and-reliability/signal-sanitizer.md): How TTMT catches decimal slips, copy-paste artifacts, and stale prices in a signal before any order is placed, using trusted reference points. - [Execution Safety](/safety-and-reliability/execution-safety.md): How TTMT protects every broker interaction — automatic safety pauses, speed control, smart retries, adaptive order sizing, market-closed skips, and hard volume caps that ignore signal-supplied lot sizes. - [Risk Limits](/safety-and-reliability/risk-limits-halt.md): Set a daily loss cap that automatically halts trading on an account — plus position caps, profit targets, and how to resume or recalibrate after a halt. - [Fast Market Conditions](/safety-and-reliability/fast-market-conditions.md): How TTMT handles volatile, fast-moving markets — adaptive layered-entry hedging, speed control, the automatic safety pause, market-closed skip, entry-zone capping, and rapid breakeven. - [Typos & Bad Signals](/safety-and-reliability/typos-and-bad-signals.md): How TTMT detects and handles poorly formatted signals, wrong values, and low-quality channels — and how to teach a channel a correction when TTMT reads a message wrong. - [Connection Resilience](/safety-and-reliability/connection-resilience.md): How TTMT keeps a reliable broker connection — the single shared streaming connection, provider options, ghost-position defense, health monitoring, position sync, and automatic reconnection. - [Position Protection](/safety-and-reliability/position-protection.md): How TTMT protects open positions with auto-breakeven, provider-dependent trailing stops, TP redistribution, conflict prevention, P&L recovery, and safe modification. - [Emergency Controls](/safety-and-reliability/emergency-controls.md): TTMT's safety net — the kill switch, automatic daily-loss halt, advisory recovery guidance, live health indicators, and stale-data warnings. ### Dashboard - [Dashboard Overview](/dashboard.md): Your TTMT command center -- navigate the dashboard to monitor trades, analyze performance, and manage your trading automation. - [Dashboard Home](/dashboard/home.md): Your trading command center — balance and equity, live positions, today's activity, a P&L calendar, and the banners that flag anything needing attention. - [Live View](/dashboard/live-view.md): Watch your open positions and pending orders update in real time across three layouts, close or breakeven positions with one click, and read the freshness and trust indicators that tell you when a price is still settling. - [Trade Log](/dashboard/trade-log.md): Your full trade history — the columns that describe each trade, the end reasons that tell you exactly why it ended, and the Trade Modal that shows a trade's whole journey. - [AI Trade Explainer](/dashboard/trade-explainer.md): A plain-English AI story of any closed trade, a graded scorecard, an event-by-event Trade Journey, and a chart with your levels drawn on — so you can see exactly what TTMT did and why. - [Signal Log](/dashboard/signal-log.md): Review every signal TTMT received — the raw message, how TTMT read it, why it was executed or skipped, and how to teach a channel when TTMT read it wrong. - [Position Log](/dashboard/position-log.md): Every individual position TTMT has opened, with its full lifecycle — entry, breakeven moves, partial closes, and final close — linked to its parent trade. - [Performance](/dashboard/performance.md): Analyze your trading: balance and equity, cumulative and daily P&L, a results calendar, key metrics, and per-channel and per-symbol breakdowns. - [Risk Limit Status](/dashboard/risk-limits-status.md): The daily-loss Risk Limit indicator in your dashboard header — what it shows, what happens when trading halts, and how to resume or recalibrate. - [Signal Tester](/dashboard/signal-tester.md): Paste any signal and watch TTMT read it and build the trade — entry, stop, take-profits, and orders — without placing anything. Test channels safely. - [Explore Channels](/dashboard/explore.md): Browse the community channel directory, compare track records by live, demo, or combined results, and enable a channel for your account in one click. - [Economic Events Calendar](/dashboard/economic-events.md): View upcoming and recent economic events, filter by currency and impact level, and avoid trading during high-impact news releases. - [Annotations](/dashboard/annotations.md): Add notes to your completed trades, build a personal trading journal, and assess signal quality to learn from every trade. - [Trash & Restore](/dashboard/trash-and-restore.md): Soft-delete closed trades and signals to declutter your logs, restore them from the Trash at any time, and learn why positions restore only with their parent trade. - [What's New](/dashboard/whats-new.md): Stay up to date with the latest TTMT features, improvements, and bug fixes -- all organized chronologically in the in-app changelog. ### Billing & Account - [Billing & Account](/billing-and-account.md): Manage your subscription, billing, profile settings, notifications, and affiliate program. - [Subscription Plans](/billing-and-account/subscription-plans.md): Compare TTMT's Essential, Pro, Master, and Challenge plans, the free demo trial, yearly savings, and how to pick the right tier. - [Lifetime Deal](/billing-and-account/lifetime-deal.md): Pay once for permanent Master-tier access. The TTMT Lifetime Deal is a one-time $1,999 purchase limited to 20 slots, including all future features. - [Challenge Tier (Prop Firm)](/billing-and-account/challenge-tier.md): The Challenge plan is a $39/mo prop-firm-optimized subscription for traders running funded-account challenges. How it differs from Essential. - [Billing Management](/billing-and-account/billing-management.md): Manage your TTMT subscription — change plans, add or remove account slots, apply discount codes, update payment, and handle past-due payments. - [Suspended Account](/billing-and-account/suspended-account.md): What happens when a subscription payment fails: the grace-period warnings, what gets paused, how your data is preserved, how to reactivate, and how billing suspension differs from an infrastructure instance pause. - [Tax & Invoicing](/billing-and-account/tax-and-invoicing.md): How VAT is handled at checkout, the EU business reverse-charge, billing-address requirements, and who TTMT bills you as. - [Affiliate Program](/billing-and-account/affiliate-program.md): Earn recurring commissions by referring traders to TTMT with the 3-tier affiliate program. - [Profile Settings](/billing-and-account/profile-settings.md): Manage your name, timezone, display currency, password, legal agreements, Telegram connection, and account deletion from your TTMT profile. - [Notifications](/billing-and-account/notifications.md): Connect the TTMT notification bot and choose which trade, signal, and error alerts you receive in Telegram. ### Troubleshooting - [Troubleshooting](/troubleshooting.md): Find solutions to common issues with connections, trade execution, signals, billing, and error messages. - [Connection Issues](/troubleshooting/connection-issues.md): Fix MetaTrader authentication failures, Telegram session drops, sync problems, and frequent disconnects — plus what a market-closed idle connection and a paused instance actually mean. - [Trade Execution Issues](/troubleshooting/trade-execution-issues.md): Why a signal did not open a trade: account halted, channel paused, market closed, blocked hours, a blacklisted term, wrong lot size, breakeven, missing SL/TP, pending orders, and the Automatic Safety Pause. - [Signal Issues](/troubleshooting/signal-issues.md): Why a signal failed, was rejected, skipped, or ignored — plus blacklist filters, teaching a channel, the Parse Lens, per-account outcomes, wrong-symbol detection, missing SL/TP, and trades that executed at a price you didn't expect. - [I'm Halted — What Now?](/troubleshooting/risk-limits-halted.md): Your account hit its Risk Limit and trading is paused. Here's what's blocked, what isn't, and how to decide between Resume and Recalibrate. - [Billing Issues](/troubleshooting/billing-issues.md): Resolve payment failures, subscription access delays, upgrade confusion, and cancellation problems — and tell a billing suspension apart from an infrastructure instance pause. - [Instance Pause & Reactivation](/troubleshooting/instance-pause-reactivation.md): What a paused trading instance is, why your data and config are preserved, how to request reactivation, and why an infrastructure pause is not a billing suspension. - [Error Messages](/troubleshooting/error-messages.md): Every error you might see in TTMT, translated to plain English with the exact next step — trading, validation, connection, market-closed, stop-out, per-trade P&L, blacklist, provider, and MetaTrader broker errors. - [FAQs](/troubleshooting/faqs.md): Answers to the most frequently asked questions about TTMT, from broker compatibility to execution speed. ### API - [Power-User API](/api.md): Read-only REST + SSE API for programmatic access to your TTMT signals, trades, live positions, and accounts. Built for bots and scripts. - [Quickstart](/api/quickstart.md): From API access grant to your first response in five steps. - [Authentication](/api/authentication.md): API key format, header shape, key lifecycle, disable versus revoke semantics, and the active-key cap. - [Rate Limiting](/api/rate-limiting.md): 30 req/min REST, 1 concurrent SSE per key, 429 responses with Retry-After, and what counts against the limit. - [Errors](/api/errors.md): RFC 9457 problem+json error envelope, common HTTP statuses, and example error bodies. - [Streaming (SSE)](/api/streaming.md): SSE live feed — connect, receive, Last-Event-ID resume, 30s auth re-check, 5-min recycle, and the full per-event catalog with example payloads. - [API Changelog](/api/changelog.md): Breaking changes and notable additions to the TTMT Power-User API. #### Endpoint Reference - [API Reference](/api/reference.md): Full endpoint reference for the TTMT Power-User Read-Only API — all nine GET endpoints. - [GET /accounts](/api/reference/list-accounts.md): List your connected MetaAPI accounts. Use the returned account_id UUIDs as the account_id filter on other endpoints. - [GET /signals](/api/reference/list-signals.md): List signals with filters and cursor pagination. Returns the most recent signals first. - [GET /signals/{id}](/api/reference/get-signal.md): Fetch a full signal by UUID, including the raw Telegram message text and parsed signal data. - [GET /trades](/api/reference/list-trades.md): List trades with filters and cursor pagination. Use ?include= to embed signal, positions, or orders inline. - [GET /trades/{id}](/api/reference/get-trade.md): Fetch a full trade by UUID with signal, positions, and orders embedded. - [GET /trades/{id}/positions](/api/reference/get-trade-positions.md): List all positions (open and closed) belonging to a specific trade. - [GET /trades/{id}/orders](/api/reference/get-trade-orders.md): List all orders (filled, pending, cancelled) belonging to a specific trade. - [GET /positions](/api/reference/list-positions.md): List currently-open positions across all your accounts, with optional single-account filter. - [GET /stream](/api/reference/get-stream.md): SSE live event feed. Streams real-time position updates, order fills, TP hits, and trade lifecycle events. ### MCP (Ask Claude) - [Ask Claude About Your Trading (MCP)](/mcp.md): Connect Claude or any MCP-compatible AI tool to your own TTMT data and ask plain-language questions about your trades, performance, settings, and risk — strictly read-only. - [MCP Quickstart — Connect in a Few Minutes](/mcp/quickstart.md): Connect Claude or any MCP-compatible AI client to your own TTMT trading data in three steps and ask your first question. - [What Claude Can Read — MCP Tool Catalog](/mcp/tools.md): The full catalog of the 19 read-only MCP tools and 5 resources Claude can use to answer questions about your own TTMT trading data. - [Guided Prompts & Example Questions](/mcp/prompts.md): The seven built-in TTMT prompts and a generous list of read-only questions you can ask Claude about your own trading data. - [MCP Security, Privacy & Limits](/mcp/security.md): How the TTMT MCP connector keeps your account safe — the read-only guarantee, OAuth sign-in, revoking access, rate limits, and the API-access gate. - [MCP Troubleshooting & FAQ](/mcp/troubleshooting.md): Fixes for MCP sign-in, consent, and connection problems, plus straight answers on read-only access, rate limits, supported clients, and data privacy. #### Client Setup - [Connect with claude.ai](/mcp/clients/claude-ai.md): Add the TTMT MCP connector to claude.ai on the web so Claude can answer read-only questions about your own trading data. - [Connect with Claude Desktop](/mcp/clients/claude-desktop.md): Add TTMT as a custom connector in the Claude Desktop app so you can ask Claude read-only questions about your own trading data. - [Connect with Claude Code](/mcp/clients/claude-code.md): Add the TTMT read-only MCP connector to Claude Code from the terminal with a single command, sign in once, and ask questions about your own trading data. - [Connect with Other MCP Clients](/mcp/clients/other-clients.md): Connect any MCP-compatible AI client that supports Streamable HTTP and OAuth 2.1 to your read-only TTMT trading data — not just Claude. ### Reference - [Reference](/reference.md): The lookup layer for TTMT — the glossary, the settings cheat sheet, the source-derived settings contract, and where to find release notes. - [Glossary](/reference/glossary.md): Definitions of TTMT terms — Risk Limits, the Adaptive Engine, trade lifecycle, channels, message filters, connection providers, Oracle, sharing — plus standard trading vocabulary. - [Quick Reference](/reference/quick-reference.md): Cheat-sheet tables — settings defaults, signal/trade/order/position statuses, the Adaptive Engine's layers, trade end reasons, Risk Limits, override modes, and common errors. - [Settings Contract](/reference/settings-contract.md): A grouped reference of every TTMT trading setting — its default, its range or options, and how it behaves — derived from the live platform. - [Changelog](/reference/changelog.md): Where to find the latest TTMT updates — the in-app What's New page, plus a curated selection of recent feature themes. ### Other - [Getting Started](/getting-started.md): Start your automated trading journey with TTMT. From account creation to your first trade in under 30 minutes.