Skip to main content

KuCoin — Spot and Futures

KuCoin's two markets (Spot and Futures) use very different symbol conventions and are exposed as two separate identifiers in TVH. KuCoin requires a Passphrase like OKX, and there's no demo or testnet — only live.

TL;DR
  • 2 exchange identifiers: kucoin (Futures), kucoin-spot (Spot)
  • Symbol formats differ: Futures XBTUSDTM (XBT + M suffix), Spot BTC-USDT (dash)
  • Leverage cap is read from the KuCoin contract spec at runtime. The adapter does not apply a hard 20× cap, your leverage value is bounded by whatever KuCoin's contract metadata returns for the pair.
  • Passphrase required — set when creating the key on KuCoin
  • No demo, no testnet — only live trading
  • All variants use https://alerts.tv-hub.org
Open Kucoin accountAffiliate link — TradingView Hub may earn a commission at no cost to you.

Webhook URL​

All KuCoin markets (Futures + Spot) use the default endpoint:

API key creation​

KuCoin's API key system is unified — one key works for both Spot and Futures if you grant both permissions. KuCoin supports third-party binding, so no IP whitelist is needed; a passphrase is still required.

  1. Log in at kucoin.com and open the top-right account menu → API Management.

    KuCoin account menu — API Management

  2. Click Create API.

    KuCoin API Management — Create API

  3. Open the Link Third-Party Applications tab, pick tv-hub.org as the third-party app, give it an API name, and set an API passphrase (you'll need this exact passphrase in TVH). Enable Spot Trading and/or Futures Trading, then click Next and complete the security verification.

    KuCoin Create API — Link Third-Party Applications, tv-hub.org, passphrase, Spot/Futures permissions

  4. Copy the Key + Secret immediately (the secret is shown only once) along with your passphrase, then add the key to TVH at Account → Settings → API Keys — once with exchange kucoin (Futures) and/or once with kucoin-spot (Spot), same Key/Secret/Passphrase both times.

Never share your secret or passphrase

The secret is shown only once. Store it safely. TV-Hub staff will never ask for your full API secret or passphrase.

Finding your KuCoin UID​

Some flows (sub-account permissions, support requests) reference your KuCoin UID — a numeric account ID separate from your username. Find it under the user dropdown.

KuCoin UID location

Variants​

KuCoin Futures​

FieldValue
Exchange identifierkucoin
Webhook URLhttps://alerts.tv-hub.org
Symbol formatXBTUSDTM, ETHUSDTM — XBT (not BTC), M suffix = perpetual
Max leveragePer-contract (read from KuCoin's contract metadata at runtime)
PermissionsGeneral + Futures Trading
PassphraseRequired
Sub-account support✅ via named apiKey field (one TVH key per sub-account)
Demo support❌ Not supported

Symbol format reference​

PairPerpetual symbol
BTCXBTUSDTM
ETHETHUSDTM
SOLSOLUSDTM
DOGEDOGEUSDTM

KuCoin Futures uses XBT instead of BTC (a legacy holdover from KuCoin Futures' early days). The M at the end stands for "Margin contract" (perpetual). Dated futures use a date suffix instead.

Example payload:

{
  "token": "your-webhook-token",
  "exchange": "kucoin",
  "pair": "XBTUSDTM",
  "isMarket": true,
  "isBuy": true,
  "units": 0.001,
  "leverage": 10,
  "marginType": "isolated"
}

Leverage cap​

The KuCoin adapter reads the max leverage from KuCoin's contract metadata at runtime. There is no hard-coded 20× ceiling in the adapter. Your leverage field is therefore bounded by whatever KuCoin currently advertises for that contract (often 100× on BTC / ETH perpetuals, less on illiquid alts).

That said, most TVH copy-trading strategies run sub-20× for survivability — KuCoin's liquidation engine has a track record of cascading on high-leverage longs during fast moves. Treat 20× as a soft personal ceiling, not an adapter-enforced one.

Sub-Accounts​

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

  1. Open the top-right account menu and go to Sub-Account.

    KuCoin account menu — Sub-Account

  2. Click Create Sub-Account.

    KuCoin Sub-Accounts — Create Sub-Account

  3. Give it a sub-account name, enable the Spot and/or Futures permissions, set a login password and an optional remark, then Save.

    KuCoin Create Sub-Account — name, Spot/Futures permissions, remark

  4. In the sub-account row's ⋯ actions menu, choose View API to create that sub-account's own API key (and Transfer to fund it).

    KuCoin sub-account row — View API and Transfer actions

  5. Add that key to TVH with a descriptive name and target it from your payload:

{
  "exchange": "kucoin",
  "pair": "XBTUSDTM",
  "apiKey": "kucoin-bot-1",
  "isMarket": true,
  "isBuy": true,
  "units": 0.001
}

Common KuCoin quirks​

  • Two symbol conventions on one exchange. Futures: XBTUSDTM. Spot: BTC-USDT. Don't paste from one chart into the other.
  • Passphrase is mandatory. Forget to enter it in TVH → "Invalid Sign" rejection.
  • Leverage is per-contract. The KuCoin adapter reads the max leverage from KuCoin's contract metadata at runtime. Treat 20× as a soft personal ceiling; the adapter does not enforce one.
  • No demo, no testnet. If you need risk-free testing, use Bybit Demo or Binance Futures Testnet instead.
  • One key, both markets. A single KuCoin API key with both Spot + Futures permissions covers both kucoin and kucoin-spot identifiers in TVH.

Feature support​

FeatureFuturesSpot
Market & Limit orders✅✅
Multiple TPs✅✅
Trailing Stop✅✅
Scaled Orders✅✅
useFixedSize✅✅
useEntireAccountBalance❌❌
Hedge Mode⚠️n/a
Sub-Accounts✅✅
Limit Order Chasing✅✅
Demo Account checkbox❌❌

Full matrix: Exchange Quirks Reference.

Last updated on