Gate CrossEx API：TradingView webhook 串 7 家交易所

你可能在 Google 打過 gate crossex api tradingview webhook——autocomplete 直接補完這句話。但點進去的前 8 個結果不是 Gate 官方寫「CrossEx 是什麼」，就是拼裝來的舊 API 教學。真正想知道的那件事「我的 TradingView alert 怎麼一個 webhook 打進 7 家交易所」，沒有一篇正面回答。

Gate CrossEx 究竟是什麼？一把 key 打進哪 7 家？

先把名詞講清楚。API，也就是應用程式對外開放的資料通道，讓你的程式直接呼叫，不用點網頁 UI。API key 是給你的程式用的那組認證字串——密碼等級，外洩就是別人可以用你的名義下單。

Gate v4 API 官方頁面對 CrossEx 的原文寫著：「CrossEx is a unified multi-venue exchange surface: Binance, OKX, Gate, Bybit, Kraken, Hyperliquid, and Deribit tie into one account shell for transfers, market data subscriptions, fills, positions, and account maintenance.」

拆解出來它做的事有三層：一個帳戶殼子（部位與成交同一組 API 讀出來）、一個下單端點（POST /crossex/orders 你指定 venue、Gate 幫你送）、一組行情端點（/crossex/market/tickers 與 /crossex/market/funding_info）。

要注意的是清單裡沒有 Bitget 與 BingX。CrossEx 不是「所有交易所」，是 Gate 選定的七家。要打這兩家仍然要用它們的原生 API。

TradingView webhook 想接進來，中間那段沒人先講

webhook，也就是 TradingView 在 alert 觸發時、對你指定的 URL 打一個 HTTP POST 的機制。TradingView 送的 payload 是你在 alert message 裡自己寫的 JSON 或純文字，格式沒有標準。

而 Gate CrossEx 的 POST /crossex/orders 要收的是 Gate 自己定義的格式——symbol（venue／business／幣對用底線串在一起，例如 BYBIT_SPOT_BTC_USDT）、side（大寫 BUY／SELL）、type（大寫 LIMIT／MARKET）、qty、price、time_in_force 這些欄位。兩邊格式不一樣，這就是那個沒人先講的段落。

這也是為什麼 Google 上「gate crossex api tradingview webhook」找不到直接答案：這件事需要你自己組，而 Gate 官方不會替你寫。這個站另外一篇 TradingView webhook 教學 有講 webhook 端的細節，可以搭配讀。

最近三個版本的 changelog 補了什麼

我把過去一個月 CrossEx 相關的 changelog 撈出來，篩掉純錯字修正。

落地方案一：自己寫一個薄 relay

最直白的做法是自己起一個 Cloudflare Worker 或一支 FastAPI 服務，收 TradingView webhook、翻譯成 CrossEx 的下單 request、簽章送出。骨架大致是：

# 收 TradingView 的 alert JSON
        {
          "secret": "your-webhook-token",
          "symbol": "BTC-USDT",
          "side": "buy",
          "qty": 0.001,
          "venue": "BYBIT"
        }

        # 翻成 CrossEx 的 order request
        POST /api/v4/crossex/orders
        {
          "symbol": "BYBIT_SPOT_BTC_USDT",
          "side": "BUY",
          "type": "MARKET",
          "qty": "0.001",
          "time_in_force": "GTC"
        }

自己寫 relay 的好處是你完全掌握送單邏輯：同一根 K 棒重複觸發要不要擋、失敗要不要重送、log 打到哪。壞處是你要維護那台服務——包含 uptime、簽章密鑰輪換、CrossEx 錯誤碼分類。

落地方案二：用第三方多所路由層——但要看清楚它有沒有走 CrossEx

現成的 TradingView 對多交易所路由服務不少——PineConnector、3Commas、我們自己的 TVSBot 都在做。差別在下面這張表。

要講清楚一件事：包括我們自己的 TVSBot 在內，這類第三方路由層沒有走 Gate 的 CrossEx endpoint——它們是對每家交易所各自的原生 API 下單。所以「一把 key 打七家」這個省事的部分只有走 CrossEx 才拿得到；走第三方路由層等於你還是要對六家各準備一把 key，但可以少寫一台 relay。

RPI 這個 TIF 值：縮寫官方有寫，行為官方沒寫

TIF（time in force），也就是這張單的有效方式——常見的有 GTC（掛到成交或手動撤）、IOC（打不進去就撤）、FOK（一次全成不然全撤）。

v4.106.109 把 RPI 加進 POST /crossex/orders 的 time_in_force 支援值。官方文件在 time_in_force 欄位定義處把它展開為 「RPI: Retail Price Improvement」，與 GTC / IOC / FOK / POC 並列。縮寫有寫，但這條 TIF 具體對應到什麼成交行為、跟一般 limit maker 差在哪，官方文件沒有再多寫一句。

一個沒人先講的坑：CrossEx 的 order state 有兩種失敗

v4.106.115 這個版本把 CrossEx 的失敗狀態分成兩層。

為什麼要分？ 因為除錯路徑不一樣：FAIL 是你的 relay 要修，REJECT 是你對那家交易所的認知要修（去查那家的最小名目、check price filter）。過去 CrossEx 只有一個籠統的錯誤欄位——你收到「下單失敗」只能猜。現在能分出來，但你的 relay 要分別 log 這兩個 state，不要只印 error message——否則升到中量之後你會回不了頭。

跟 跨交易所套利入門 那篇要處理的失敗類別差不多，只是層級不一樣：那篇是機會消失，這篇是單本身被誰擋。

誠實的一段：我沒有實測 CrossEx 帳號怎麼申請

Gate v4 API 文件沒有直接寫「CrossEx 帳號需要另外開通、只支援 API 交易」這件事——只在 CrossEx 頁的最下面放了一個 CrossEx help desk 連結指向 help center。我沒有跑過完整申請流程，也沒有實測「非 API 用戶能不能在 web UI 動 CrossEx 部位」。這篇談的一切都建立在你已經拿到一把可以打 /crossex/orders 的 key 這個前提上。如果你正在申請階段卡住，那不在這篇的範圍。

常見問題