Skip to main content

Binance — Spot, Futures USD-M, Futures Coin-M

Binance is the largest crypto exchange by volume. TVH supports the full lineup: Spot, Futures USD-M, Futures Coin-M, and all three testnets. Binance is the one exception to the default webhook URL — both Spot and Futures use binance.tv-hub.org, not alerts.tv-hub.org.

TL;DR
  • 5 exchange identifiers: binance (Spot), binance-futures (USD-M), binance-futures-testnet, binance-futures-coin, binance-futures-coin-testnet
  • Different webhook URL for all Binance variants: binance.tv-hub.org (the TVH API Keys UI auto-selects this for both binance and binance-futures)
  • Hedge Mode supported via "hedgeMode": true on both Futures variants
  • Demo Account checkbox is supported for Binance Spot and Binance Futures USD-M. Coin-M has no demo path, use the testnet identifier instead.
  • Symbol formats: BTCUSDT (Spot + USD-M), BTCUSD_PERP (Coin-M)
Open Binance accountAffiliate link — TradingView Hub may earn a commission at no cost to you.
Test on a Binance demo account first

Binance Spot and USD-M Futures support paper trading via the Demo Account checkbox. Full setup: Demo Accounts → Binance.

Variants​

Binance Spot​

FieldValue
Exchange identifierbinance
Webhook URLhttps://binance.tv-hub.org (selected by the TVH UI)
Symbol formatBTCUSDT, ETHUSDT, SOLUSDT — no separator
Min notional~$5 (exchange-enforced)
Max leveragen/a (spot — use Binance Margin for leveraged spot)
Permissions requiredRead + Spot Trading
Sub-account support✅ via named apiKey field (one TVH key per sub-account)
Demo path✅ Demo Account checkbox — routes the key to Binance's paper-trading endpoint

Webhook URL:

Binance IP whitelist — paste these into the key's IP-restriction field:

20.194.185.150 20.191.169.179 20.191.172.69 20.48.71.250 20.191.172.206 20.191.173.63 20.191.174.156 20.191.175.88 20.78.104.150 20.78.105.3 20.78.105.95 20.78.105.134 20.78.105.150 20.191.175.195 20.78.105.154 20.78.105.162 20.78.105.172 20.78.105.244 20.78.106.67 20.78.106.119 20.78.106.130 20.48.71.143 20.78.106.137 20.78.106.149 20.78.106.151 20.191.173.152 20.78.106.157 20.78.106.166 20.46.190.72 20.78.106.172 20.43.67.38 13.69.68.7 52.174.236.207 52.174.236.246 52.174.236.136 52.232.16.136

Example payload:

{
  "token": "your-tvh-token",
  "exchange": "binance",
  "pair": "BTCUSDT",
  "isMarket": true,
  "isBuy": true,
  "units": 0.01,
  "unitsType": "absolute"
}

API key creation​

  1. Log in at binance.com.
  2. Account → API Management.
  3. Click Create API, pick System generated, give it a name like tvh-spot.
  4. Pass email + 2FA verification.
  5. Edit restrictions:
    • Restrict access to trusted IPs only — paste TVH IPs (see Webhook URLs & IP Whitelist).
    • Enable Enable Spot & Margin Trading.
    • Leave Enable Withdrawals ❌ off.
  6. Save Key + Secret to TVH at Account → Settings → API Keys.

Binance API Management menu Binance API key permissions Binance IP restrictions save

Common Binance quirks​

  • Position Mode must be set first. Before your first trade in Hedge Mode, switch the Binance Futures account from One-way to Hedge Mode in the Binance UI. TVH's hedgeMode: true will fail if the account is still on One-way.
  • Margin type is per-pair AND per-account. Switching from Isolated to Cross on BTC doesn't affect ETH. TVH sets it on every trade if marginType is specified, but the change can fail mid-position if you already have an open position on that pair.
  • Sub-account trading uses one TVH API key per sub-account — see Sub-accounts below.
  • One key, one Futures contract type. A Coin-M and USD-M position both count against the same Futures-permission key. You don't need separate keys for the two.

Sub-accounts​

Binance sub-accounts are routed via the named apiKey field — one TVH API key per sub-account:

  1. In Binance, open Sub Accounts and click + Create Sub Account — pick Create with virtual email and give it a label like StrategyBTC.

    Binance — Create Sub Account button

  2. A virtual-email sub-account cannot be logged into directly, so create its API key from the main account (manage the sub-account's API from the master UI).

    Binance — Create Sub Account dialog with virtual email

  3. Add that key to TVH with a descriptive name, then target it from your payload via "apiKey": "<TVH key name>".

Feature support​

FeatureSpotFutures USD-MFutures Coin-M
Hedge Moden/a✅✅
useFixedSize (quote sizing)✅✅✅
useEntireAccountBalance❌❌❌
Multiple TPs✅✅✅
Trailing Stop✅✅✅
Scaled Orders✅✅✅
Limit Order Chasing✅✅✅
Sub-Accounts✅✅✅

Full matrix: Exchange Quirks Reference.