TradingView 快訊能自動下單嗎?Webhook 怎麼運作、重送規則與防重複下單

(歡迎點選上方橫幅廣告,瞭解更多關於Firstrade的資訊)

重點整理

  • TradingView 官方說明寫明:快訊(alert)不是為自動交易設計的,策略也只能在回測模式執行。Webhook 做的事,是快訊觸發時把訊息用 HTTP POST 送到你指定的網址;要下單,得自己架接收端,再接到期貨商提供的下單程式。
  • 官方送出規格:只送往 80、443 埠,接收端要在 3 秒內回應,不支援 IPv6,帳號要開兩步驟驗證;送出的 IP 固定 4 個,可以拿來設白名單。
  • 接收端回 500~599(504 除外)時,TradingView 隔 5 秒重送,最多重送 3 次,一次觸發最多收到 4 筆同樣的訊息。
  • 防重複下單靠兩層:接收端用冪等鍵擋掉同一次觸發的重送;下單前拿策略的目標部位跟帳戶實際部位對帳,只送差額。
  • 策略快訊只在即時 K 棒上有成交時發出,3 分鐘內觸發超過 15 次會被停掉;改了圖上的策略設定,要刪掉快訊重建才會生效。

一、Webhook 是什麼:快訊觸發後送出一筆 HTTP POST

Webhook 是「事情發生時,由對方主動打你的網址」的通知方式。TradingView 的快訊在它自己的伺服器上執行,關掉瀏覽器也照常觸發;觸發時,把快訊訊息放在 POST 請求的內容(body)裡送出。

從快訊到成交中間有三段,每段要防的事不同。

段落誰負責要防的事
快訊觸發、送出TradingView 伺服器訊號重繪、快訊被停用或到期
接收端自己架的伺服器冒名請求、重送造成重複、3 秒逾時
下單程式自己的程式+期貨商 API斷線、送出不等於成交、部位對不上
  • 建立策略快訊時,TradingView 會在伺服器上複製一份策略獨立執行。之後改圖上的參數,伺服器那份不會跟著改,要刪掉快訊重建。
  • 期貨商 API 怎麼登入、怎麼送單,各家規定不同,以各家官方文件為準。

小結:TradingView 負責把訊息送出去,接收、判斷、下單、對帳都在自己這一端。

二、官方送出規格:IP、連接埠與 3 秒逾時

項目TradingView 官方規定
送出的 IP52.89.214.238、34.212.75.30、54.218.53.128、52.32.178.7
連接埠只接受 80、443,其他埠會被拒絕
回應時間接收端超過 3 秒沒處理完,請求取消
網路不支援 IPv6;網址解析到本機或內部 IP 會被擋
帳號開了兩步驟驗證才能用 Webhook
格式訊息是合法 JSON 就帶 application/json,否則帶 text/plain
驗證來源走 HTTPS 時會附憑證,欄位 CN 是 webhook-server@tradingview.com
  • 官方另外提醒:帳號、密碼這類登入資料不要放在網址或訊息裡。
  • 每一次送出的結果,在快訊紀錄(alert log)的「Webhook status」欄看得到。

例題:假設接收端收到訊息後,同步等期貨商回覆委託結果才回應,送單加回報花了 4 秒。TradingView 在第 3 秒取消請求,快訊紀錄記成逾時,那筆單卻已經送出去了。所以接收端要先回應再處理:收到就回 200,把訊息放進佇列,下單程式另外處理。

小結:接收端只做三件事:檢查來源、檢查有沒有收過、放進佇列,然後馬上回應。

三、訊息格式:用 JSON 和佔位符帶出訂單內容

快訊訊息裡可以放佔位符(placeholder),觸發時換成實際的值。策略快訊常用這幾個佔位符。

佔位符觸發時換成
{{ticker}}商品代號
{{time}}觸發那根 K 棒的時間(UTC)
{{timenow}}快訊觸發的時間(UTC,到秒)
{{strategy.order.id}}成交那筆委託的 ID(strategy.entry 的第一個參數)
{{strategy.order.action}}buy 或 sell
{{strategy.order.contracts}}成交口數
{{strategy.position_size}}成交後策略的部位(多單為正、空單為負)

訊息範例,填在快訊的訊息欄。

{"ticker": "{{ticker}}", "id": "{{strategy.order.id}}",
 "action": "{{strategy.order.action}}", "contracts": "{{strategy.order.contracts}}",
 "target": "{{strategy.position_size}}", "bar_time": "{{time}}"}
  • 冪等鍵(idempotency key)的意思是:同一筆請求送幾次,結果都跟送一次一樣。做法是組一串「同一次觸發都相同、不同觸發都不同」的字,這裡用商品、委託 ID、買賣方向、K 棒時間四個欄位。
  • {{timenow}} 在重送時會不會變,官方沒有寫,所以不拿它組冪等鍵。
  • target 帶的是成交後應該有的部位,下單程式拿它跟帳戶實際部位比,只送差額(第六節)。

小結:訊息用 JSON,欄位裡至少要有組冪等鍵的資料和目標部位。

四、重送規則:一次觸發最多收到 4 筆

TradingView 說明中心〈Webhook resubmission〉的規定整理成下表。

接收端的回應官方重送規則
500~599,504 除外隔 5 秒重送,最多 3 次
504不重送
其他狀態碼、逾時、連不上重送規則沒有列,看快訊紀錄的錯誤訊息

例題:假設接收端已經把訊息交給下單程式,接著在回應前出錯,回了 500。5 秒後同一筆訊息再送來,沒有冪等鍵就會再下一次單。照最多重送 3 次算,最壞的情況是 1 口的訊號送出 4 口。

  • 另外兩種重複,冪等鍵擋不住:同一個策略建了兩個快訊;指標快訊選了「每根 K 棒一次」,訊號在 K 棒中途出現又消失,之後又出現。這兩種要靠第六節的對帳。
  • 策略快訊 3 分鐘內觸發超過 15 次會被停掉。這是 TradingView 那端的上限,迴圈寫錯時要靠自己的程式設下單頻率上限擋住。

小結:重送是為了讓訊息送得到,接收端要自己保證同一筆只處理一次。

五、接收端示意:Python 標準庫,擋重送、先回應再下單

這支接收端只用 Python 標準庫,在 Python 3.13 實際跑過。它檢查來源 IP、用 SQLite 記下收過的冪等鍵,把新訊息放進佇列後馬上回應。

import json, queue, sqlite3, threading
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

TV_IPS = {"52.89.214.238", "34.212.75.30", "54.218.53.128", "52.32.178.7"}
TEST_IPS = {"127.0.0.1"}   # 只給本機測試,上線前拿掉
db = sqlite3.connect("seen.db", check_same_thread=False)
db.execute("CREATE TABLE IF NOT EXISTS seen (key TEXT PRIMARY KEY)")
lock = threading.Lock()
jobs = queue.Queue()

def first_time(key):
    with lock:
        try:
            db.execute("INSERT INTO seen VALUES (?)", (key,))
            db.commit()
            return True
        except sqlite3.IntegrityError:
            return False

def worker():
    while True:
        msg = jobs.get()
        # 這裡接自己的下單程式:先對帳,再算要送幾口
        print("交給下單程式:", msg, flush=True)

class Hook(BaseHTTPRequestHandler):
    def do_POST(self):
        if self.client_address[0] not in TV_IPS | TEST_IPS:
            return self.reply(403, "ip not allowed")
        body = self.rfile.read(int(self.headers.get("Content-Length", 0)))
        try:
            msg = json.loads(body)
            key = "|".join(msg[k] for k in ("ticker", "id", "action", "bar_time"))
        except (ValueError, KeyError, TypeError):
            return self.reply(400, "bad message")
        if not first_time(key):
            return self.reply(200, "duplicate")
        jobs.put(msg)
        self.reply(200, "queued")

    def reply(self, code, text):
        self.send_response(code)
        self.end_headers()
        self.wfile.write(text.encode())

threading.Thread(target=worker, daemon=True).start()
ThreadingHTTPServer(("0.0.0.0", 8080), Hook).serve_forever()

在本機用 curl 送了三次,結果如下。

送出的內容回應有沒有交給下單程式
第三節格式的 JSON(第一次)200 queued有
同一筆 JSON 再送一次(模擬重送)200 duplicate沒有
純文字 TXF1! Crossing 40000400 bad message沒有
  • 收過的重複訊息照樣回 200。回 5xx 會再引來重送。
  • 冪等鍵存在 SQLite 檔,程式重開也記得;欄位設成 PRIMARY KEY,「查有沒有收過」和「記下來」一步完成,兩筆同時進來也只會有一筆成功。
  • 這支聽 8080 埠,TradingView 只送 80、443:實際使用要放在有 HTTPS 憑證的反向代理(reverse proxy)後面。程式看到的來源會變成代理的 IP,所以白名單要改在代理那一層檢查。
  • worker 那段只印出訊息,實際要接自己的下單程式。

小結:這支示意只處理「同一筆不要做兩次」,部位對不對要靠下一節。

六、斷線與對帳:送不到、送兩次都要對得回來

狀況會發生什麼處理方式
接收端當機訊息送不到,快訊紀錄顯示錯誤重開後先對帳,漏掉的訊號從快訊紀錄補查
下單程式跟期貨商斷線訊息留在佇列裡暫停下單、重連、查委託與部位,一致才恢復
冪等鍵擋不住的重複收到兩筆內容不同的訊息用 target 對帳,只送差額
快訊被停用或到期不再送出定時檢查快訊狀態

例題:假設策略成交後 target 是 1,也就是多單 1 口。

帳戶實際部位差額下單程式怎麼做
多單 1 口0不送單
0 口買 1 口送買進 1 口
多單 2 口超過目標停止下單,通知人工處理
  • 斷線後的處理順序(暫停、重連、查詢、比對)和委託回報怎麼看,〈期貨券商 API 串接實務〉有完整表格;單日虧損熔斷、定時對帳、心跳通知在〈程式交易實盤風控怎麼設〉。
  • 訊號本身會不會閃現,要從源頭處理:Pine Script 官方文件說,避免快訊重繪最簡單的方法是把頻率設成「每根 K 棒收盤一次」(Once per bar close),代價是要等 K 棒收完。策略預設只在 K 棒收盤時計算,除非用了 calc_on_every_tick = true。腳本寫法的檢查看〈用 ChatGPT、Claude 寫交易程式〉第四節。

小結:冪等鍵管「同一筆」,對帳管「部位對不對」,兩層都要有。

常見問題

TradingView 可以直接連期貨帳戶自動下單嗎?

官方說明中心〈How to autotrade using Pine Script strategies〉寫的是:策略交易只限回測模式,用券商帳戶自動執行策略目前還沒開放。快訊加 Webhook 能做到的是把訊號送出去,下單在自己的程式裡完成。

Webhook 可以送到家裡的電腦嗎?

網址要能從外面連到,而且只能用 80 或 443 埠;解析到本機或內部 IP 的網址會被擋。家裡的電腦還會遇到停電、斷網、系統更新重開機,主機放哪裡可以看〈程式交易實盤風控怎麼設〉的雲端主機段。

自動下單的帳戶要放多少錢?

上實單從最小口數開始,帳戶放到一口價值的三分之一以上,整體槓桿控制在三倍以下:假設台指期 40,000 點,微台一口價值 40 萬元,帳戶至少放約 13.3 萬元。可以用 opop.tw 的〈台指期真實槓桿計算機〉換成自己的口數試算。

延伸閱讀

你想投資美股嗎?試試從Firstrade開始

買賣美股、ETF、選擇權均享 $0 佣金,完全中文化介面並設有中文客服

來Firstrade開始你的海外交易吧!點擊下方圖片瞭解更多相關資訊

分享你的喜愛
我愛期貨
我愛期貨
文章: 159