永豐 Shioaji API 開通傻瓜教學(共三篇)

  1. 第 1 篇:簽署 API 條款
  2. 第 2 篇:申請 API Key、下載憑證(您正在看這篇)
  3. 第 3 篇:安裝 Python、模擬測試、正式開通

這篇做完,您會拿到 4 樣東西

東西長什麼樣子用途
🔑 API Key一長串英數字程式登入用(像帳號)
🔒 Secret Key一長串英數字程式登入用(像密碼)
📄 電子憑證檔副檔名 .pfx 的檔案正式下單時證明是您本人
🔢 憑證密碼打開憑證用的密碼搭配憑證檔使用

開始前請先準備好手機(要收驗證碼),並在電腦上開一個記事本,等一下拿到的金鑰馬上貼進去存好。

Part A:申請 API Key

步驟 1

打開 API 管理頁並登入

用電腦打開:https://www.sinotrade.com.tw/newweb/PythonAPIKey/

(這是永豐金理財網 → 個人服務 → API 管理)

步驟 2

按「新增API KEY」,完成手機/Email 驗證

系統會寄驗證碼到您的手機或 Email,輸入後才能繼續。

步驟 3

設定到期日,權限「全部打勾」

到期日可以選久一點,免得常常要重新申請。權限照下表勾:

權限用途要勾嗎?
行情 / 資料看報價、K 線✅ 勾
帳務查餘額、庫存、損益✅ 勾
交易下單(第 3 篇測試一定要有)✅ 一定要勾
正式環境開通後真的下單✅ 一定要勾

下方的帳戶也記得勾:證券帳戶、期貨帳戶有幾個就勾幾個。

步驟 4

IP 限制(看不懂可以先不設)

IP 限制是「只允許某台電腦連線」,官方建議設定比較安全。但家用網路的 IP 常常會變,設錯了程式會登不進去。新手可以先不設,等程式穩定、放到固定的電腦或雲端主機後,再回來補設。

步驟 5

⚠️ 馬上把 API Key 和 Secret Key 複製下來!

申請成功後畫面會顯示兩串金鑰。Secret Key 只會出現這一次,關掉就再也看不到了,請立刻複製貼到記事本存檔。

Shioaji API Key 申請成功範例畫面

不小心沒存到也別緊張:把舊的刪掉,重新按一次「新增API KEY」就好。

Part B:下載電子憑證

步驟 6

在同一頁按「下載憑證」

一樣在 API 管理頁,找到「下載憑證」按鈕,下載後會得到一個 .pfx 檔案(通常在「下載」資料夾)。

步驟 7

建一個資料夾 C:\shioaji,把憑證放進去

打開「本機」→「C 槽」→ 按右鍵「新增資料夾」,取名 shioaji,再把剛剛的 .pfx 檔拖進去。

💡 資料夾名稱用英文、不要有空白,程式比較不會出錯。第 3 篇的測試檔也會放在這裡。

步驟 8

確認憑證密碼

憑證密碼一般預設為您的身分證字號(英文字母大寫);如果您申請憑證時有自己改過,就用改過的密碼。不確定的話,加 LINE 問我。

金鑰=您帳戶的鑰匙,請務必保管好

1. 不要傳給任何人,也不要截圖貼到群組、論壇。任何人跟您要 Secret Key 都不要給(包括自稱客服的人)。

2. 懷疑外流時,立刻到 API 管理頁刪除那組金鑰,再重新申請一組。

3. 記事本檔案存在自己的電腦就好,不要上傳雲端分享。

程式交易合規與風險聲明

1. 本系列僅介紹永豐金證券官方提供之 Shioaji API 開通與環境建置步驟,畫面與流程以永豐金證券官方最新公告及 Shioaji 官方文件為準。本人不提供、媒介或推介任何非屬本公司之第三方證券交易分析、買賣建議或全權委託軟體。

2. 所有交易策略之演算法、參數設定及程式邏輯均由交易人自行編寫、回測與決定,本公司及業務人員不對任何程式策略之獲利能力作任何保證。

3. 程式交易可能因網路中斷、硬體異常、交易所線路延遲或設定錯誤產生交易風險,交易人應備妥電話人工委託等替代管道並做好風險控管。

開通過程卡關?歡迎加 LINE(autotrade-wu)傳截圖給我,一起幫您排除。