V1.0.3 STABLELAST UPDATED: 2026-03-27

使用說明與開發文檔

5 分鐘完成 TradingView 與 MT5 / Broker 的全自動對接。

01. 快速開始

獲取 API Key
在 Dashboard 建立專屬 API Key
設置 TW Webhook
填入伺服器端點 URL,發送 JSON 格式訊息
對接指令
本地端 Client 配置API KEY 及 市場設置

02. TradingView 設置

(註: 需要TradingView Premium 或以上Plan)

1

在 TradingView 右手方點擊 點擊「快訊」 > 「建立快訊」。

2

點擊 「通知」 分頁，勾選 「Webhook URL」。

3

填入 Webhook 地址：
https://pineany.com/webhook

4

點擊 「<」回 「建立快訊」 分頁，點擊 「訊息」將下方的 JSON 代碼貼入 「訊息」 欄位。

YOUTUBE片
YouTube

03. 指令規範

MT5_WEBHOOK_PAYLOAD
{
  "api_key": "your_api_key_here",
  "alertid": "MT5",
  "symbol": "HK50",
  "action": "buy",
  "qty": 1,
  "price": 24700,
  "sl": 24500,
  "tp": 25000
}

MT5 專屬參數說明

  • • alertid: 建議每次訊號使用唯一 ID 防止重複觸發。
  • • symbol: 格式需符合經紀商要求（如 HK50, HK50.Cash）。
  • • action: 支持 closebuy / closesell / closeall 等平倉指令。
  • • price: 設為 0 則代表以市價盤發送至交易所。
  • • sl / tp: 支援 MetaTrader 5 的硬性止損盈。
參數名稱類型必須設置說明
keyString您的 API Key。用於識別帳號與經紀商對接。
alertidString自訂一個alertid 以防止重覆下單, 如MT5FUTU
symbolString商品名稱，如 XAUUSD HK.00700。如 Dashboard 設置 '交易品種白名單' 會有所限制
actionString執行動作：'buy' /'sell'(MT5 Only: 'closebuy' / 'closesell' / 'closeall')。
qtyFloat數量： 交易數量/股數 。'buy' /'sell' 時必須設置
priceFlota如有設定則為 限價盤 (NORMAL)，若設為 0 或不設定則為 市價盤 (MARKET)。
slFloatMetaTrader 5 的硬性止損位。(MT5 Only)
tpFloatMetaTrader 5 的硬性止盈位。(MT5 Only)

使用 'buy'

**開啟多單 (Long Position)**。系統會根據您的 `qty` 在端點建立買入訂單。

使用 'sell'

**開啟空單 (Short Position)**。系統會根據您的 `qty` 在端點建立賣出訂單。

MT5 進階平倉：使用 'closeall' 會立即平掉該 API Key 下該 Symbol 的所有持倉。

04. 本地端 Client 配置 (Futu OpenD / MT5)

安裝軟件： FUTU OpenD (Futu User)

本地端需要安裝 FUTU OpenD以連接PineAny Client.

詳情可以到https://support.futunn.com/ > 量化与Open API > Open API > Open API 介绍 > Futu OpenD / Futu API 下载

安裝軟件： MT5 (EA User)

本地端需要安裝 Broker 所提供MT5 軟件. 詳情可以到 所使用的Broker 的網頁了解 下載MT5 軟件 及 導入PineAny EA。

0.5. 本地端 PineAny 配置

請到下載 並解壓 pineany-client.zip，並修改目錄下的 config.txt 文件以完成對接。

config.txt - 配置範例UTF-8

            [PINEANY_SETTING]
            # 這裡填入您在 Dashboard 獲取的 API Key
            SSE_URL = https://asia.pineany.com/
            API_KEY = your_api_key_here
            MT5_API_KEY = your_api_key_here


            # 富途 OpenD 設置 (若使用 MT5 則不需理會此區)
            [FUTU_SETTING]
            #預設FUTU OPEND 連接口 
            FUTU_OPEND_HOST = 127.0.0.1
            FUTU_OPEND_PORT = 11111

            #交易環境: REAL / SIMULATE
            TRD_ENV = SIMULATE

            #STOCK (REAL/SIMULATE): HK /US 
            #FUTURES (REAL ONLY): FUTURES
            #FUTURES (SIMULATE ONLY): FUTURES_SIMULATE_HK / FUTURES_SIMULATE_US 
            MARKET = HK

            #FUTU 交易所使用戶口 
            #用show_account.exe 取得
            ACC_ID =  

            #FUTU真實下單密碼
            FUTU_PASSWORD = 

            #風限金額
            MAX_ORDER_AMOUNT = 500000

            # MT5 設置 (若使用 富途 OpenD 則不需理會此區)
            [MT5_SETTING]
            PIPE_NAME = \.pipeMT5_Trade_Pipe
            #風限金額
            MAX_ORDER_AMOUNT = 500000

重要： API_KEY 一致性

`config.txt` 內的 API_KEY 必須與您發送 Webhook JSON 內的 key 完全一致，否則訊號將無法下發。

關於 ACC_ID 參數

ACC_ID 需填入您在FUTU的帳號ID, 可以用show_account.exe取得相關(REAL/SIMULATE)戶口。

05. FAQ