# TradingView Hub (TV-Hub)

> Automated TradingView alerts to crypto exchanges. No custom code required.

TradingView Hub (TVH) turns TradingView alerts into live trades on crypto exchanges. You define a trade command as a JSON payload, point a TradingView webhook (or the Telegram bot or Chrome extension) at TVH, and TVH executes it on your exchange using your own exchange API keys. This file maps the documentation so an AI assistant can answer questions and help you build correct trade commands.

## Quick Reference

- /llms-full.txt: Complete TradeCommand JSON spec (84 fields).
- /schemas/trade-command.schema.json: JSON Schema Draft 2020-12.
- Main webhook: POST https://alerts.tv-hub.org (auth token goes in the body).

## Documentation Map

### Getting Started

- [TradingView Hub Docs](/docs/): Connect TradingView alerts to major crypto exchanges. Start with a 5-minute demo trade.
- [Account & API Keys](/docs/account-and-api-keys): How to add exchange API keys to TradingView Hub, enable demo mode, and use our free affiliate-tier access.
- [Demo Accounts - Paper Trading & Strategy Testing](/docs/demo-accounts): Free demo / paper-trading accounts on Bybit, OKX, and Binance. Test strategies risk-free, then go live by swapping the API key.
- [Binance Demo](/docs/demo-accounts/binance): Binance demo (paper-trading) accounts for TradingView Hub. Spot and USD-M Futures support the Demo Account checkbox.
- [Bybit Demo](/docs/demo-accounts/bybit): Bybit demo (paper-trading) account for TradingView Hub. The Quickstart covers the full setup.
- [OKX Demo](/docs/demo-accounts/okx): OKX Demo Trading for TradingView Hub. Built into the same okx identifier, no separate testnet.
- [E-Mail Signals - Webhook Backup](/docs/email-backup): Use TradingView E-Mail alerts as a backup layer so trades still fire when a webhook is lost in transit.
- [Quickstart - First Demo Trade in 5 Minutes](/docs/quickstart): Wire a Bybit demo account to TradingView Hub. Create a demo API key, paste one JSON payload, verify the fill. Zero risk.
- [Webhook URLs & IP Whitelist](/docs/webhook-urls-and-ip): All TradingView Hub webhook endpoints, when to use which, and the IP ranges to whitelist on your exchange.

### Trade Command

- [Activity Log - Verify Every Trade](/docs/activity-log): The TVH Activity Log is the source of truth for every trade. Read entry types, filter by exchange or type, reveal the raw trade command, and sort.
- [Quickly Test a Trade](/docs/test-a-trade): Fire a single trade on demand to confirm your API key, webhook, and payload work, before you wire up a live alert.
- [Trade Command - The Webhook JSON Schema](/docs/trade-command/): Complete reference for the TradingView Hub webhook payload. All 84 fields, with defaults, examples, and gotchas.
- [Advanced Trade Options](/docs/trade-command/advanced): A map of every advanced trade-command field, grouped by what it controls, with links to each detail page.
- [Trade Command Anatomy & Auto-Mapping](/docs/trade-command/anatomy): How the server interprets your JSON payload, including TVH's strategy-alert auto-mapping, math expressions, and TradingView placeholders.
- [Before You Go Live - 5 Safety Checks](/docs/trade-command/before-you-go-live): Run these checks before switching from demo to real funds: demo fill, symbol format, market/limit behavior, SL/TP, and duplicate-order protection.
- [Close & Cancel Fields](/docs/trade-command/close-and-cancel): TradeCommand fields for closing positions and cancelling pending orders. closeCurrentPosition, closeLong/Short, cancel cascade.
- [Conditional Logic - Pyramiding, Profit-Only Close, Partial Close](/docs/trade-command/conditional-logic): Anti-pyramiding guards, conditional pyramiding, profit-only close, partial-close mechanics.
- [Core Parameters - Exchange, Pair, Direction, Token](/docs/trade-command/core-parameters): The required fields of every TradeCommand - exchange, pair, order direction, and authentication.
- [DCA & Scaled Order Fields](/docs/trade-command/dca-and-scaling): TradeCommand fields for DCA (order-mesh) entries and scaled order ladders across a price range.
- [Debug a Failed Trade Alert](/docs/trade-command/debug-a-failed-alert): Your alert did not produce a trade? Check Activity Log first, then match the error to the likely fix.
- [11 Trade Command Examples - Pine + JSON Side by Side](/docs/trade-command/examples): Complete working examples for every common TradingView Hub use case. Long, short, hedge, DCA, trailing, and more.
- [Futures-Specific Fields - Leverage, Margin, Hedge](/docs/trade-command/futures-options): TradeCommand fields that only apply to futures. Leverage, marginType, hedgeMode, postOnly, workingType.
- [15 Common TradeCommand Mistakes (and How to Fix Them)](/docs/trade-command/gotchas): The pitfalls users hit when building TradingView Hub webhooks - postOnly default, symbol format, auto-close, and more.
- [Limit Order Management - Chase, Update, Limit Close](/docs/trade-command/limit-order-management): TradeCommand fields that control limit-order chasing, in-place updates, fallback to market, and limit-style closes.
- [Math Expressions for Stop Loss & Take Profit](/docs/trade-command/math-expressions): Use stopLossExpression and takeProfitExpression for dynamic SL/TP. Pine placeholders, smart sign flipping, error handling.
- [Parameter Reference - All 84 Properties](/docs/trade-command/parameter-reference): Complete table of every TradeCommand JSON field with type, default, category, and a one-line description.
- [Sizing - Units, Percent, Fixed Quote](/docs/trade-command/sizing): TradeCommand position sizing fields. Absolute units, percent of balance, fixed quote size, entire account balance.
- [Stop Loss & Trailing Stop Fields](/docs/trade-command/stop-loss): All TradeCommand stop loss fields. Absolute, percent, trailing, break-even, SL-only update payloads.
- [Take Profit Fields & LimitOrder Targets](/docs/trade-command/take-profit): TradeCommand take-profit configuration. Targets array, percent vs absolute, multi-TP, trailing per target.
- [Timing & Idempotency Fields](/docs/trade-command/timing-and-idempotency): The timing-related TradeCommand fields, alertTimestamp, delay, and retries.

### Trade Command Builder

- [Trade Command Builder - Complete UI Walkthrough](/docs/trade-command-builder/): Build a TradingView Hub trade command without writing JSON. Every control of the Trade Command Builder interface explained and mapped to its payload field.

### Pine Script

- [Alert Message JSON - Format & Escaping](/docs/pine-script/alert-message-format): How to format the JSON payload in TradingView's alert Message field. Quote escaping, sources, sanity checks.
- [TradingView Alert Setup for TVH](/docs/pine-script/alerts-setup-basics): Configure TradingView alerts to fire TVH webhooks. Frequency, Plain Text, Webhook URL field, alert expiration.
- [Official TVH Boilerplate Pine Strategy](/docs/pine-script/boilerplate-strategy): Drop-in Pine v5 strategy template with TVH input fields. GitHub repo, walkthrough, customization.
- [Pine Strategy Cookbook - 7 Ready-to-Copy Strategies](/docs/pine-script/cookbook): Complete Pine v5 strategy templates for TradingView Hub. EMA crossover, RSI pullback, breakout, DCA.
- [Indicator-Based Alerts](/docs/pine-script/indicator-alerts): Wire up indicator signals to TVH webhooks using Pine v5 alert() calls or static alert messages.
- [TradingView Placeholders for Dynamic TVH Payloads](/docs/pine-script/pine-placeholders): Full reference for TV's {{placeholder}} tokens and how to use them in TradingView Hub trade commands.
- [Strategy-Based Alerts with Position Tracking](/docs/pine-script/strategy-alerts): Build Pine strategies that emit correct TVH payloads via strategy.entry/exit/close + alert_message.

### Exchanges

- [Supported Exchanges Overview](/docs/exchanges/): Compare Binance, Bybit, OKX, KuCoin, Coinbase and BitMex support in TradingView Hub. Demo accounts, futures, leverage caps.
- [Binance - Spot, Futures USD-M, Futures Coin-M](/docs/exchanges/binance): Connect Binance Spot, USD-M Futures, and Coin-M Futures to TradingView Hub. API key setup, hedge mode, BNFCR, testnets.
- [BitMex - Futures with Testnet](/docs/exchanges/bitmex): Connect BitMex (live + testnet) to TradingView Hub. XBT symbol naming, cross vs isolated, leverage slider trick.
- [Bybit - Futures Unified, Spot, Demo Account](/docs/exchanges/bybit): Connect Bybit UTA Futures, Spot, and Demo Account to TradingView Hub. API key setup, setTpToPosition, useEntireAccountBalance.
- [Coinbase - Spot + Futures (Perpetual & Expiring)](/docs/exchanges/coinbase): Connect Coinbase Advanced Trade to TradingView Hub. Spot, Perpetual Futures, Expiring contracts, symbol format gotchas.
- [Common Exchange Setup Workflow](/docs/exchanges/common-setup): The universal 4-step pattern for connecting any exchange to TradingView Hub - API key, permissions, IP whitelist, demo mode.
- [KuCoin - Spot and Futures](/docs/exchanges/kucoin): Connect KuCoin Spot and Futures to TradingView Hub. API key setup, passphrase, UID, symbol format quirks.
- [OKX - Unified Account (Spot, Margin, Futures, Swap)](/docs/exchanges/okx): Connect OKX to TradingView Hub. instrumentType, positionSide, passphrase, demo account, symbol format with dashes.
- [Exchange Quirks Reference](/docs/exchanges/quirks): All TradingView Hub exchange quirks in one reference. Symbol formats, demo support, feature matrix, leverage caps for Binance, Bybit, OKX, KuCoin, Coinbase, BitMex.

### Features

- [Batch Alerts & Timing Controls](/docs/features/batch-and-timing): Send multiple trade commands in one alert via square-bracket syntax. Configure delays, idempotency via alertTimestamp, email-backup override with delay -1.
- [Hedge Mode - Long + Short Simultaneously](/docs/features/hedge-mode): Enable Binance Futures hedge mode in TVH. Open opposite directions on the same pair, direction-aware close, OKX positionSide and Bybit equivalents.
- [Save, Load, Paste Trade Commands](/docs/features/save-load-paste): Reuse trade setups in TVH. Save by name, load from a list, or paste an existing JSON to edit it visually in the Trade Command Builder.
- [Sub-Accounts - Strategy Isolation via Named API Keys](/docs/features/sub-accounts): Route TVH trades to a specific exchange sub-account using named API keys. Setup per exchange, master-key permissions, naming conventions.

### Copy Trading

- [Copy Trading Overview - Signals, Follow, Broadcast](/docs/copy-trading/): Peer-to-peer copy trading on TVH. Create signal sources, share via email, broadcast trades, mirror across accounts.
- [Broadcast a Signal to Followers](/docs/copy-trading/broadcast-a-signal): Fire a TVH copy trade to all followers via broadcastSignal field. Setup, latency, close cascade.
- [Create a Copy Trading Signal Source](/docs/copy-trading/create-a-signal): Set up a new Signal Source in TVH. Name, pairs, exchange, description. Step-by-step with screenshots.
- [Follow a Signal - Create a Copy Trade](/docs/copy-trading/follow-a-signal): Subscribe to a TVH signal source. Configure your size, leverage, and optional SL/TP override per copy trade.
- [Copy Trading Risk Management](/docs/copy-trading/risk-management): Best practices for TVH copy trading. Override hierarchy, follower discipline, signal provider responsibilities, common failures.
- [Share Your Signal with Others](/docs/copy-trading/share-with-others): Invite other TVH users to follow your signal source via email. Bulk invites, revoking access, privacy notes.

### Telegram

- [TradingView Hub Telegram Bot - Forward Signals, Manage Trades](/docs/telegram/): Use the TVH Telegram bot to forward signals from public channels, manage positions via chat, and get trade notifications.
- [Telegram Bot Commands - Close, Break-Even, Cancel](/docs/telegram/bot-commands): Manage open positions via TVH Telegram bot commands. /trade menu, Close, Set to Break-Even, Cancel DCA, Cancel All.
- [Telegram Bot Setup](/docs/telegram/setup): Enable the TVH Telegram bot, copy your Access Key, /start in Telegram, paste, and configure your first trade setting.
- [Forward Signals to the TVH Telegram Bot](/docs/telegram/signal-forwarding): Forward trade signals from public Telegram channels to TVH bot for automatic execution. Step-by-step.
- [Telegram Bot Trade Settings - Sizing, DCA, Filters](/docs/telegram/trade-settings): Configure API key, sizing mode, leverage, DCA, and Symbol/Channel filters for the TVH Telegram bot.

### Chrome Extensions

- [TVH Chrome Extensions - Power Tool & Strategy Finder](/docs/chrome-extensions/): Two Chrome extensions extend TVH inside TradingView. Trading Power Tool for one-click manual trading, Strategy Finder for backtesting at scale.
- [Strategy Finder - Backtest at Scale](/docs/chrome-extensions/backtest-extension-overview): Optimize Pine strategy parameters automatically with the TVH Strategy Finder Chrome extension. Sequential vs Smart mode, CSV export, free tier.
- [Strategy Finder Free Tier - Lifetime via Bybit](/docs/chrome-extensions/backtest-free-tier): Get lifetime free Strategy Finder access by opening a new Bybit account via TVH referral, completing KYC, depositing, and linking the API key.
- [Strategy Finder Search Modes - Sequential vs Smart](/docs/chrome-extensions/backtest-search-modes): Compare exhaustive Sequential search vs heuristic Smart mode. Drawdown filter, search criteria, walk-forward validation.
- [Trading Power Tool - One-Click Manual Trading Extension](/docs/chrome-extensions/trading-power-tool): Install and use the TVH Trading Power Tool Chrome extension. Scaled orders, risk sizing, multi-TP, copy trading, cross-exchange from TradingView.

### Api Reference

- [TVH HTTP API Reference Overview](/docs/api-reference/): TradingView Hub public API endpoints. Webhooks for signals. Base URLs and auth model.
- [TVH API Error Codes & Common Failures](/docs/api-reference/error-codes): Complete list of HTTP status codes and TVH-specific error responses. Common failure scenarios and fixes.
- [Webhook Endpoints - Execute Trade Signal](/docs/api-reference/webhooks): TVH webhook receivers for TradeCommands. Queued vs Classic variants, request/response schemas, batch payloads, idempotency, code examples in curl/Python/Node.

### For Llms

- [For AI Assistants & Power-Prompt Users](/docs/for-llms/): TVH documentation optimized for AI consumption. llms.txt, llms-full.txt, JSON Schema, prompt templates, common hallucination fixes.
- [TradeCommand Canonical Schema (Plain Text)](/docs/for-llms/canonical-schema): All 84 TradeCommand properties as plain text for direct LLM context loading. Also as JSON Schema for tool-use APIs.
- [Common LLM Hallucinations - TVH Field Names and Fixes](/docs/for-llms/common-mistakes): 16 most common LLM hallucinations when generating TVH Pine + JSON. Wrong field names, wrong types, invented enum values - and the correct rewrites.
- [How to Prompt ChatGPT/Claude for TVH Pine + JSON](/docs/for-llms/how-to-prompt): Golden prompt template + 4 concrete examples for getting working Pine v5 strategies and JSON payloads from LLMs.
- [TVH Strategy Templates - LLM-Ready Pine + JSON](/docs/for-llms/strategy-templates): Eight starter templates with Pine v5 code + matching schema-correct TVH JSON. Designed for LLM customization without hallucination.

### Affiliate

- [TVH Affiliate Program - Up to 35% Commission](/docs/affiliate/): Refer users to TradingView Hub and earn up to 35% of their subscription. Three tiers, customizable split, no audience minimums.
- [TVH Affiliate - Setup, Customize, Share Your Link](/docs/affiliate/setup-and-sharing): Set up your TVH affiliate link, customize the slug, share on social media, and adjust the kickback-vs-discount split.
- [TVH Affiliate Stats and Payout Request](/docs/affiliate/stats-and-payout): Track your referral stats and request payouts in BTC, ETH, USDT. Minimum threshold, processing time, FAQ on tax and refunds.

### Reference

- [TVH Changelog](/docs/reference/changelog): Release notes for TradingView Hub features, API changes, and documentation updates.
- [TVH Glossary - Terms and Definitions](/docs/reference/glossary): Alphabetical glossary of all TradingView Hub-specific terminology. From alertTimestamp to Working Type.
- [TVH Support - Get Help](/docs/reference/support): How to get help with TradingView Hub. Community channels, direct support, bug reporting, feature requests, security disclosure.

## Guides & SEO Landing Pages

In-depth guides, exchange landing pages, and comparison articles on the main site (outside /docs).

### Guides

- [The Ultimate Guide to Automating Crypto Trading with TradingView Signals in 2026](/guide/tradingview-automation): Learn how to build a profitable automated trading system using TradingView signals and TV-Hub. Complete guide from setup to advanced strategies for 24/7 crypto trading.
- [Best Crypto Trading Bots for Beginners (2026) - Complete Setup Guide](/guide/crypto-trading-bots-beginners): Complete guide to crypto trading bots. Compare bot types, understand automation strategies, avoid costly mistakes. From setup to live trading. Free trial!
- [How to Set Up TradingView Alerts (2026) - Free & Paid Plans Explained](/guide/tradingview-alerts-setup): Step-by-step TradingView alerts setup. Webhook configuration, JSON placeholders, alert limits by plan. Automate any strategy. Works with free plan!
- [12 Automated Trading Mistakes That Cost Crypto Traders Millions (And How to Avoid Them)](/guide/automated-trading-mistakes): Discover the 12 most expensive automated trading mistakes that have cost crypto traders millions. Learn proven prevention strategies to protect your capital and avoid common pitfalls.
- [Successful Automated Trading Case Studies That Generated Consistent Profits](/success-stories): Discover 5 real success stories of automated trading strategies that transformed ordinary traders' results. See actual performance data, learn exact methods, and understand why automation succeeded where manual trading failed.
- [Crypto Trading Bots: The Good, the Bad, and What Actually Works in 2026](/guide/crypto-trading-bots-pros-cons): Honest breakdown of crypto trading bot pros and cons. 65-80% of crypto volume is automated. Real costs, risks, strategies that work, and how to start smart in 2026.
- [Is Automated Trading Profitable? Real Data & Guide [2026]](/guide/is-automated-trading-profitable): Is automated trading profitable? We analyze real data: 60% of algo traders show positive returns. Strategies, costs, mistakes to avoid, and how to start. 2026 guide.
- [Spot Algorithmic Trading: A Simple Guide to Automating Crypto Trades](/guide/spot-algorithmic-trading): Learn spot algorithmic trading for crypto. 7 proven strategies, no-code setup, risk management, and step-by-step guide. No leverage needed. Start with $500.
- [TradingView Backtesting: Strategy Tester Guide (2026)](/guide/tradingview-backtesting): Learn how to use TradingView's Strategy Tester the right way. Understand backtest metrics, avoid costly mistakes, and optimize strategy parameters - complete 2026 guide.
- [Best Crypto Scalping Bots 2026: What Actually Works](/guide/crypto-scalping-bots): Most crypto scalpers lose money after fees. We break down the best crypto scalping bots, real cost math, and risk rules that separate winners from losers.
- [Crypto Prop Firms: What Nobody Tells You About Getting Funded in 2026](/guide/crypto-prop-firms): 93% of crypto prop firm traders never see a payout. Here's what you actually need to know about success rates, the 2024-2025 crisis, and how to evaluate firms before putting money on the line.
- [What Is Bitcoin Dominance? How to Read BTC.D Like a Pro in 2026](/guide/bitcoin-dominance): Bitcoin Dominance sits at 57% in March 2026. Learn the BTC.D formula, why stablecoins distort the metric, historical trends since 2017, and 5 ways to trade with it.
- [Market Neutral Strategy in Crypto: Does It Actually Work?](/guide/market-neutral-strategy-crypto): Market neutral crypto funds gained 14.4% in 2025 while directional funds lost money. Learn the 5 strategy types, real performance data, and how to set one up.
- [How to Automate TradingView Watchlist Alerts Into Live Trades](/guide/tradingview-watchlist-alerts): 100M+ TradingView users can now automate watchlist alerts into live trades. Step-by-step tutorial with video for dynamic multi-pair webhook automation.

### Exchange Landing Pages

- [Connect TradingView to Binance: Complete Automation Guide 2026](/tradingview-to-binance): Learn how to connect TradingView alerts to Binance for automated crypto trading. Step-by-step guide with webhook setup. Start trading 24/7 in minutes.
- [Binance Futures Automation: TradingView Alerts to Futures Trading Bot](/tradingview-to-binance-futures): Automate Binance Futures trading with TradingView alerts. Safe leverage management, liquidation protection, and 24/7 position monitoring. Start your free trial.
- [Coinbase Automated Trading: TradingView Setup Guide 2026](/tradingview-to-coinbase): Master Coinbase automated trading in 10 minutes. Save 60% on fees. Works with TradingView free plan. 7-day trial, no credit card. Join 35,000+ traders.
- [Connect TradingView to OKX: Webhook Setup in 10 Minutes (2026)](/tradingview-to-okx): Connect TradingView to OKX in 10 minutes. Step-by-step webhook setup, API key config, unified account support. Works with free plan. 7-day trial!
- [Connect TradingView to Bybit: Complete Webhook Automation Guide 2026](/tradingview-to-bybit): Automate Bybit trading with TradingView webhook alerts. Unified account support, derivatives automation, FREE demo account. Complete setup guide.
- [BitMEX Trading Bot: Automate TradingView to BitMEX with 100x Leverage Safety](/tradingview-to-bitmex): BitMEX trading bot for TradingView alerts. Safe 100x leverage automation, liquidation prevention, professional tools. Start free with demo account today!
- [Automate KuCoin Trading: TradingView Alerts Setup Guide | 700+ Pairs](/tradingview-to-kucoin): Connect TradingView to KuCoin in 10 minutes. Automate 700+ trading pairs with free plan alerts. No coding required. Start gem hunting 24/7 with TV-Hub.

### Comparisons

- [7 Best Crypto Exchanges for TradingView Automation (2026 Ranked)](/compare/best-crypto-exchanges): Compare Binance, Bybit, OKX, KuCoin for automated trading. API reliability, fees, TradingView integration ranked. Find your perfect trading exchange.
- [Best Alertatron Alternative: TradingView Hub vs Alertatron (2026)](/compare/alertatron-alternative): Compare TradingView Hub vs Alertatron: Multi-exchange trading automation, email backup reliability, flat pricing vs per-trade fees. See why 35,000+ traders switched to TV-Hub in 2025.
- [Alternative to WunderTrading: TradingView Hub vs WunderTrading (2026)](/compare/tv-hub-vs-wundertrading): Compare TradingView Hub vs WunderTrading for crypto trading automation. See why 35,000+ traders choose TV-Hub for Telegram integration, better pricing, and reliable alerts. Free trial available.
- [Best 3Commas Alternative for TradingView Users (2026)](/compare/3commas-alternative): Looking for a 3Commas alternative? TradingView Hub offers demo account trading, granular signal control, transparent pricing, and no bot limits. Free trial available.

### Tools & Calculators

- [Crypto Position Size Calculator](/position-calculator): Calculate position size, leverage, margin, and liquidation price for any trading pair.
- [Crypto Converter](/crypto-converter): Convert values between crypto assets and fiat across trading pairs.
- [TradingView to Bybit - All Trading Pairs](/tradingview-to-bybit/trading-pairs): Every Bybit trading pair you can automate from TradingView with TVH.
- [Bybit Crypto Converter](/bybit/convert): Convert Bybit trading-pair values in both directions.