永豐 Shioaji API 開通傻瓜教學(共三篇)
- 第 1 篇:簽署 API 條款
- 第 2 篇:申請 API Key、下載憑證(您正在看這篇)
- 第 3 篇:安裝 Python、模擬測試、正式開通
這篇做完,您會拿到 4 樣東西
| 東西 | 長什麼樣子 | 用途 |
|---|---|---|
| 🔑 API Key | 一長串英數字 | 程式登入用(像帳號) |
| 🔒 Secret Key | 一長串英數字 | 程式登入用(像密碼) |
| 📄 電子憑證檔 | 副檔名 .pfx 的檔案 | 正式下單時證明是您本人 |
| 🔢 憑證密碼 | 打開憑證用的密碼 | 搭配憑證檔使用 |
開始前請先準備好手機(要收驗證碼),並在電腦上開一個記事本,等一下拿到的金鑰馬上貼進去存好。
Part A:申請 API Key
打開 API 管理頁並登入
用電腦打開:https://www.sinotrade.com.tw/newweb/PythonAPIKey/
(這是永豐金理財網 → 個人服務 → API 管理)
按「新增API KEY」,完成手機/Email 驗證
系統會寄驗證碼到您的手機或 Email,輸入後才能繼續。
設定到期日,權限「全部打勾」
到期日可以選久一點,免得常常要重新申請。權限照下表勾:
| 權限 | 用途 | 要勾嗎? |
|---|---|---|
| 行情 / 資料 | 看報價、K 線 | ✅ 勾 |
| 帳務 | 查餘額、庫存、損益 | ✅ 勾 |
| 交易 | 下單(第 3 篇測試一定要有) | ✅ 一定要勾 |
| 正式環境 | 開通後真的下單 | ✅ 一定要勾 |
下方的帳戶也記得勾:證券帳戶、期貨帳戶有幾個就勾幾個。
IP 限制(看不懂可以先不設)
IP 限制是「只允許某台電腦連線」,官方建議設定比較安全。但家用網路的 IP 常常會變,設錯了程式會登不進去。新手可以先不設,等程式穩定、放到固定的電腦或雲端主機後,再回來補設。
⚠️ 馬上把 API Key 和 Secret Key 複製下來!
申請成功後畫面會顯示兩串金鑰。Secret Key 只會出現這一次,關掉就再也看不到了,請立刻複製貼到記事本存檔。
不小心沒存到也別緊張:把舊的刪掉,重新按一次「新增API KEY」就好。
Part B:下載電子憑證
建一個資料夾 C:\shioaji,把憑證放進去
打開「本機」→「C 槽」→ 按右鍵「新增資料夾」,取名 shioaji,再把剛剛的 .pfx 檔拖進去。
💡 資料夾名稱用英文、不要有空白,程式比較不會出錯。第 3 篇的測試檔也會放在這裡。
確認憑證密碼
憑證密碼一般預設為您的身分證字號(英文字母大寫);如果您申請憑證時有自己改過,就用改過的密碼。不確定的話,加 LINE 問我。
金鑰=您帳戶的鑰匙,請務必保管好
1. 不要傳給任何人,也不要截圖貼到群組、論壇。任何人跟您要 Secret Key 都不要給(包括自稱客服的人)。
2. 懷疑外流時,立刻到 API 管理頁刪除那組金鑰,再重新申請一組。
3. 記事本檔案存在自己的電腦就好,不要上傳雲端分享。
這篇完成了!下一步
程式交易合規與風險聲明
1. 本系列僅介紹永豐金證券官方提供之 Shioaji API 開通與環境建置步驟,畫面與流程以永豐金證券官方最新公告及 Shioaji 官方文件為準。本人不提供、媒介或推介任何非屬本公司之第三方證券交易分析、買賣建議或全權委託軟體。
2. 所有交易策略之演算法、參數設定及程式邏輯均由交易人自行編寫、回測與決定,本公司及業務人員不對任何程式策略之獲利能力作任何保證。
3. 程式交易可能因網路中斷、硬體異常、交易所線路延遲或設定錯誤產生交易風險,交易人應備妥電話人工委託等替代管道並做好風險控管。
開通過程卡關?歡迎加 LINE(autotrade-wu)傳截圖給我,一起幫您排除。