Shioaji Pro教學｜永豐證券API申請
Shioaji Pro 怎麼用？永豐證券/期貨下單完整教學
如果你是永豐金證券或永豐期貨的客戶，平常除了使用一般 APP 下單，也想嘗試更進階的看盤、交易、策略回測或 AI 輔助功能(可把您訂閱的 claude / codex 導入 )、甚至是自己製作下單功能 ，可以認識一下 Shioaji Pro。
Shioaji Pro 是以永豐 Shioaji API 為核心打造的免費桌面交易開放平台，支援股票、期貨與選擇權，並整合即時行情、K 線、五檔、閃電下單、停損停利、OCO、自訂指標、策略回測及 AI Agent 等功能。
而且桌面版已經內建 Shioaji Server，一般使用者不需要另外安裝 Python，也不需要自己寫程式才能開始使用。
第一次接觸 API 也不用擔心，下面直接按照順序操作即可。
- Shioaji Pro 系統需求
- STEP 1｜先完成 API 下單簽署
- STEP 2｜下載並安裝 Shioaji Pro
- STEP 3｜申請 API Key 與 Secret Key
- STEP 4｜第一次登入「模擬環境」
- STEP 5｜完成 API 模擬測試
- STEP 6｜準備 CA 交易憑證
- STEP 7｜切換 Shioaji Pro 正式環境
- Shioaji Pro 一定要會 Python 才能使用嗎？
- Shioaji Pro 可以先模擬交易嗎？
- 永豐證券 API Key 在哪裡申請？
- 股票跟期貨 API 要分開申請嗎？
- Shioaji Pro 正式環境需要憑證嗎？
- 使用 Shioaji Pro AI Agent 一定要付費嗎？
- 我要的功能沒有怎麼辦?
- 支援那些作業平台環境?
- 永豐證券／期貨開戶與 Shioaji Pro 使用
Shioaji Pro 系統需求
目前 Shioaji Pro 桌面版支援：
Windows 10／11 x64
macOS 13.3 以上
Linux x86_64
下載網址：
https://sinotrade.github.io/shioaji-pro-app?landing=new
安裝完成後，建議先從「模擬環境」開始，等熟悉操作並完成 API 測試後，再切換到正式交易環境。
Shioaji Pro 如何開始？完整設定流程
整個流程其實可以簡單記成：
API 簽署 → 安裝 Shioaji Pro → 申請 API Key → 登入模擬環境 → 完成測試委託 → 準備憑證 → 正式環境
下面一步一步說明。
STEP 1｜先完成 API 下單簽署
想使用 Shioaji API 進行證券或期貨交易，第一步先完成 API 相關文件簽署。
使用大戶投 APP
證券：
大戶投 APP → 左上角人頭 → 簽署中心 → 證券類 → API 證券下單簽署
期貨：
大戶投 APP → 左上角人頭 → 簽署中心 → 期貨類 → API 期貨下單簽署
使用愛利得 APP
證券：
愛利得 APP → 數位 E 櫃台 → 簽署中心 → 證券類 → API 證券下單簽署
期貨：
愛利得 APP → 數位 E 櫃台 → 簽署中心 → 期貨類 → API 期貨下單簽署
⚠️ 證券與期貨需要分開簽署。
只交易股票，就完成證券 API 簽署。
有交易期貨，就再完成期貨 API 簽署。
如果股票、期貨都要使用，兩項都需要完成。
STEP 2｜下載並安裝 Shioaji Pro
進入 Shioaji Pro 官方下載頁：
https://sinotrade.github.io/shioaji-pro-app?landing=new
依照自己的電腦系統下載安裝：
Windows → Windows x64
Mac → Apple Silicon 或 Intel
Linux → 選擇對應版本
安裝完成後即可準備 API Key。
STEP 3｜申請 API Key 與 Secret Key
登入 永豐金理財網：
登入理財網 → 點選右上角姓氏圖案 → API 管理 → 新增 API KEY
API Key 的名稱可以自己設定，例如：Shioaji Pro
接著設定需要使用的權限及帳戶，完成驗證後，就會取得：
API Key以及Secret Key
⚠️ Secret Key 建立後只會顯示一次，記得立即保存。
API Key 與 Secret Key 就像登入 API 的帳號密碼，請勿傳給其他人，也不要公開在網路、LINE 群組或程式碼中。
STEP 4｜第一次登入「模擬環境」
開啟 Shioaji Pro。
輸入剛才取得的：
API Key 與 Secret Key
環境選擇：模擬環境
接著按下：啟動並開始使用
即可進入 Shioaji Pro 模擬環境。
第一次建議先在這裡熟悉看盤、下單、刪單、改價、持倉以及停損停利等操作。
因為是模擬環境，不會直接動用真實資金，比較適合第一次使用 Shioaji Pro 的客戶。
STEP 5｜完成 API 模擬測試
如果之後要使用「正式環境」交易，還需要完成 API 測試。
主要包含兩個部分：
① API 登入測試
確認 API Key 與 Secret Key 可以正常登入。
② 模擬委託測試
於模擬環境完成測試委託。
證券與期貨的 API 測試需要分開完成。
只做股票 → 完成證券 API 測試
有做期貨 → 再完成期貨 API 測試
股票＋期貨 → 則兩邊都要完成
目前 API 測試服務時間為：星期一～星期五 08:00～20:00
完成後，可以回到簽署中心確認 API 測試是否已通過。
⚠️ 記得「API 下單簽署」要先完成，再進行模擬測試。
STEP 6｜準備 CA 交易憑證
模擬環境可以先使用 API Key 操作，但進入正式交易環境前，需要準備 CA 交易憑證。
如果你之前已經使用過永豐的：
好神通、eLeader、SFT
而且這台電腦已經安裝過交易憑證，直接選取原本的憑證即可。
Windows 預設憑證位置：
本機磁碟 C → ekey → 551 → 身分證字號 → S → sinopac.pfx
如果電腦沒有交易憑證，可以登入永豐金理財網，在 API 管理或憑證管理功能下載交易憑證。
STEP 7｜切換 Shioaji Pro 正式環境
確認前面的流程全部完成後，就可以切換正式環境。
正式登入前確認：
✅ API 下單文件已簽署
✅ API Key 已建立
✅ Secret Key 已保存
✅ 模擬環境登入正常
✅ API 模擬委託測試完成
✅ API 測試已通過
✅ CA 交易憑證已準備完成
接著開啟 Shioaji Pro：
輸入 API Key＋Secret Key
環境選擇：
正式環境
再選取自己的 CA 交易憑證。
最後按：
啟動並開始使用
即可進入正式交易環境。
⚠️ 請注意，正式環境送出的股票、期貨或選擇權委託，都是真實交易。
第一次使用建議先充分熟悉模擬環境，再切換正式環境。
Shioaji Pro 可以做什麼？
Shioaji Pro 並不只是單純把 API 做成下單介面。
目前可以使用包含：
即時行情、K 線與五檔報價
股票／期貨／選擇權下單
閃電下單
停損停利
OCO 智慧單
持倉與即時損益
委託刪單與改量
自訂交易版面
技術指標
自訂指標
策略建立與回測
AI Agent
對於習慣多螢幕看盤、短線交易、期貨交易，或想進一步接觸策略交易與 API 的投資人，都是值得研究的新工具。
Shioaji Pro AI Agent 是什麼？
Shioaji Pro 桌面版還整合 AI Agent。可導入您訂閱的 Claude/Codex/Pi Agent
可以透過 AI 對話方式，協助處理例如自訂指標、交易策略、回測分析以及部分交易相關工作流程。
如果要啟用 AI Agent，則依照選擇的 AI Provider，準備相對應的 AI 帳號、API 或訂閱資格。
也就是說：
一般 Shioaji Pro 看盤與交易 ≠ 一定要訂閱 AI
只有希望進一步使用 AI Agent 功能時，才需要另外設定 AI 服務。
Shioaji Pro 常見問題 FAQ
Shioaji Pro 一定要會 Python 才能使用嗎？
不用。
Shioaji Pro 桌面版已經內建 Shioaji Server，一般客戶下載安裝後，即可透過圖形化介面使用，不需要先學 Python 才能開始。
Shioaji Pro 可以先模擬交易嗎？
可以。
第一次登入建議直接選擇「模擬環境」，先熟悉看盤與下單方式。
要進入正式環境交易，才需要完成 API 簽署、測試及憑證等相關設定。
永豐證券 API Key 在哪裡申請？
登入永豐金理財網：
右上角姓氏圖案 → API 管理 → 新增 API KEY
完成驗證及權限設定後，就可以取得 API Key 與 Secret Key。
Secret Key 請記得第一次取得時就保存好。
股票跟期貨 API 要分開申請嗎？
API 下單簽署及測試部分，證券與期貨需要分開完成。
只使用股票，就完成證券相關流程。
如果同時要交易期貨，則期貨相關簽署及測試也要完成。
Shioaji Pro 正式環境需要憑證嗎？
需要。
進入正式環境交易時需要 CA 交易憑證。
如果原本這台電腦已經使用好神通、eLeader 或 SFT 並安裝過永豐交易憑證，通常可以直接使用原本憑證，不需要重複申請。
使用 Shioaji Pro AI Agent 一定要付費嗎？
一般 Shioaji Pro 看盤、下單與平台功能並不是一定要訂閱 AI。
如果要使用內建 AI Agent，則需依使用的 AI 服務準備相關帳號、API 或訂閱資格。
我要的功能沒有怎麼辦?
這套開放式平台就是讓客戶可以自己做， 利用app coding 或自己設計
source code裡面有範例，可參考https://github.com/Sinotrade/shioaji-pro-app
不會自己做的客戶當然就是由杜經理提需求單 公司也會逐步去更新她 但就是變成傳統方式
沒有完全符合本平台精神
支援那些作業平台環境?
系統需求： macOs 13.3以上 / Windows 10/11 x64 / Linux x86_64
Shioaji Pro 新手最簡單記法
第一次使用，只要記住這個順序：
① 簽署 API 文件 → ② 下載 Shioaji Pro → ③ 申請 API Key＋Secret Key → ④ 進入模擬環境 → ⑤ 完成 API 測試委託 → ⑥ 準備 CA 交易憑證 → ⑦ 切換正式環境 → ⑧ 開始使用
如果你以前覺得「API 下單」就是一定要會寫程式，其實 Shioaji Pro 已經把使用門檻降低很多。
建議永豐證券、永豐期貨客戶可以先從模擬環境開始，熟悉平台的看盤與交易方式，再決定要不要進一步使用正式交易、策略回測或 AI Agent 等進階功能。
其餘相關參考網頁 :
金鑰與憑證申請，可參閱
https://sinotrade.github.io/zh/tutor/prepare/token/
SHIOAJI Pro內的 AI Agent，要有自己的AI訂閱
功能說明，可參閱
https://github.com/Sinotrade/shioaji-pro-app
永豐證券／期貨開戶與 Shioaji Pro 使用
如果你還沒有永豐證券或永豐期貨帳戶，可以再進一步詢問。
永豐金證券 業務經理 杜昭逸
協助證券開戶、期貨開戶、複委託，以及相關交易平台使用說明。
【風險提醒】
※ Shioaji Pro 仍持續更新，實際功能名稱、操作畫面及申請方式如有調整，請以永豐金證券及 Shioaji 官方最新公告為準。
本文主要提供 Shioaji Pro 平台操作與設定流程說明，不構成任何投資建議或獲利保證。正式環境所送出的委託屬於真實交易，股票、期貨及選擇權交易均具有市場風險，使用前請充分了解商品及相關交易規則。
本單位與永豐金證券不擔保各項資訊內容之正確性、即時性、完整性或可靠性，且所有資訊內容不代表任何形式之推介、要約、承諾、勸誘或保證，亦不應被解讀為投資建議。對於使用者依本網站提供資訊進行任何投資行為所產生之風險與盈虧，不負任何責任。
永豐金證券及本網站任何資訊內容之提供者因軟、硬體設備之瑕疵、故障、不可抗力或人為操作上之疏失，導致資訊傳輸之遺漏、錯誤、遲延、障礙或中斷等異常情事，永豐期貨不負任何責任。
一般留言