v1.05 線上版最後更新：2026-04-20

開發者文檔

將 TradingView 警報對接至 MetaTrader 5 或富途牛牛。PineAny Client 完整設置指南。

01. 快速上手

系統執行流程
Pineany Process Diagram
下載客戶端
從儀表板下載最新版本的壓縮檔並解壓至您的電腦。
配置 API
將您的個人 API Key 填入 config.txt 配置文件中。
啟動交易
執行客戶端程式，開始接收來自 TradingView 的訊號。

02. TradingView 設置 (註: 需要TradingView Plus Plan或以上)

1

建立快訊

在 TradingView 右側工具列點擊「快訊」圖示並建立新快訊。

2

選擇條件

選擇您的策略或指標觸發條件。

3

Webhook URL

切換至「通知」分頁，勾選 Webhook URL 並貼上 API 地址。

https://api.pineany.com/webhook
4

填寫訊息

在「訊息」欄位中，貼入下方產生的 JSON 代碼。

更詳細的安裝步驟及圖片介紹 可以到 下載區 下載最新的使用手冊

03. Webhook 參數規範

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

MT5 專屬參數

  • • alertid: 警告 ID (使用 MT5 或 STOCK)
  • • symbol: 交易品種白名單 (例如 HK50, GOLD)
  • • action: 動作 (buy, sell, close, etc.)
  • • price: 價格 (0 為市價單)
  • • sl/tp: 支援止損與止盈設置
參數名稱類型必填說明
keyString/Float您的 PineAny API Key (從控制台獲取)
alertidString/Float平台標識：使用 'MT5' 或 'STOCK'
symbolString/Float交易品種代碼
actionString/Float執行動作 (buy/sell/close...)
qtyString/Float交易數量 (手數或股數)
priceString/Float執行價格 (0 代表市價單)
slString/Float止損價格 (僅限 MT5)
tpString/Float止盈價格 (僅限 MT5)

04. 本地端 Client 配置

下載 PineAny Client

前往官網下載 pineany-client.zip 並解壓，您將看到以下關鍵檔案：

Config.txt

MT5 user client.exe

Futu user client.exe

pineanyEA.ex5

show_account.exe

重要提示：

  • MT5 Tip: 將 pineanyEA.ex5 複製到 MT5 的 MQL5/Experts 資料夾內。
  • Futu Tip: 必須先安裝並登入 Futu OpenD，確保連線狀態為綠燈。
  • 確保電腦防火牆允許上述 .exe 檔案訪問網路。

配置 Config.txt 內容

EDITING: config.txtUTF-8
[PINEANY_SETTING]
 # 這裡填入您在 Dashboard 獲取的 API Key

API_KEY = your_api_key_here (FOR FUTU)
MT5_API_KEY = your_api_key_here (FOR MT5)


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

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

#交易環境: REAL (真實) / SIMULATE (模擬)
TRD_ENV = SIMULATE

#用show_account.exe 取得
ACC_ID = 

#FUTU PASSWORD: 新版 FUTU OpenD GUI 屏蔽了 API 解鎖，請確保您已在 OpenD 軟體上手動完成解鎖

#風限金額
MAX_ORDER_AMOUNT = 500000

#====================MT5 設置 (若使用 富途 OpenD 則不需理會此區)====================
[MT5_SETTING]

#MT5 連線通管. 如一電腦有多個MT5 要設置不同的PIPE_NAME
PIPE_NAME = PineAny_MT5_Pipe

#風限金額
MAX_ORDER_AMOUNT = 500000

05. 常見問題

06. 錯誤代碼

如果客戶端返回錯誤代碼，請參考以下錯誤代碼文檔 或 MQL5 官網交易返回碼 以了解具體原因。

錯誤代碼文檔