Skip to content

Sinotrade/shioaji-pro-app

Repository files navigation

Shioaji Pro — 專業交易終端 Trading Terminal

官方網站 / Landing Page下載 Download

A professional, fully-customizable trading terminal for Taiwan markets (TWSE / TPEX / TAIFEX), built on the Shioaji HTTP API + SSE streaming. React 19 + TypeScript + Vite, zero backend code — it talks directly to your local shioaji server.

以 Shioaji HTTP API 打造的專業交易終端:即時行情、K 線、五檔、閃電下單、 圖表點價下單、停損停利觸價單、可拖拉的自訂版面。

Shioaji Pro — futures night session

Features 功能

  • 即時行情 — 單一 SSE 連線串流 tick / 五檔,自選清單成交閃動(只在真實成交時閃,試撮不閃)
  • K 線圖 — lightweight-charts,1m/5m/15m/60m/1D,即時 tick 更新當根 K 棒
    • 點價下單:點圖表價位直接限價買賣
    • 停損 / 停利:在圖上掛觸價單(觸價送市價單),虛線顯示、可取消
    • 委託管理:未成交委託顯示為實線、overlay 有 CANCEL 按鈕、拖曳委託線即改價
    • Hover 同步:十字線價位即時同步到下單面板
  • 閃電下單 — 價格梯點擊即下單(左欄買/右欄賣),含安全開關
  • 五檔報價 — 量能條視覺化,點價帶入下單面板
  • 成交明細 — 開啟即載入歷史 tick,時間精確到微秒
  • 下單面板 — 整股/零股、ROD/IOC/FOK、期貨倉別,兩段式確認防誤觸
  • 持倉 / 委託 / 帳務 — 即時損益、刪單、權益數與保證金
  • 排行榜 — 漲幅 / 量 / 額 scanner,點擊即加入追蹤
  • 交易安全 — 風控 Kill Switch(單筆上限/日虧上限/一鍵鎖單)、 Esc×2 全部刪單、括號單(成交後自動掛 OCO 停損停利)、持倉一鍵平倉/反手、 委託改量、下單預估成本(手續費/稅/契約值)
  • 快捷鍵 — B/S 切換買賣、Esc×2 全刪單、⌘K 商品搜尋跳轉
  • 技術指標 — MA5/10/20/60、EMA、布林通道、VWAP 疊圖
  • 大盤狀態列 — 加權指數與台指期基差常駐頂部
  • 到價警示 — 圖上點擊設警示線(只通知不下單),音效+toast
  • 分析面板 — 損益分析(權益曲線/勝率/賺賠比)、分價量表+內外盤比、 個股籌碼卡(融資券/借券/處置股)、選擇權 T 字報價(TXO)
  • 行情回放 — 重播當日歷史 tick 練盤感(1x–100x 變速)
  • 委託簿熱圖 — 五檔掛單牆的時間序列視覺化
  • 自訂版面 — react-grid-layout 拖拉移動/縮放,面板可任意新增(多開 K 線圖)、 每個面板可「連動自選」或「鎖定商品」、可彈出成獨立視窗(多螢幕)、 版面可命名儲存/載入
  • 音效回報 — 成交/委託/警示分音色(可關閉)
  • 斷線自愈 — SSE 重連後自動重新訂閱所有商品
  • 主題 — 深色 / 純黑 / 淺色 × 紅漲綠跌(台式) / 綠漲紅跌(美式)
Dark Light
dark light

Desktop App 桌面版(推薦)

Releases 下載對應平台安裝檔 (macOS .dmg、Windows .msi、Linux .AppImage/.deb/.rpm)。桌面版特色:

  • 內建 shioaji server(sidecar)— 不需另外安裝 CLI
  • 伺服器管理介面 — header「伺服器」選單:啟動/停止/重啟、健康狀態、 PID/port、token 效期;API 金鑰在介面填寫(存於本機 App 資料夾)
  • 模擬/正式環境切換 — 介面上切換,重啟伺服器生效
  • 系統匣(Menu Bar) — 關閉視窗縮到系統匣常駐;匣選單可叫回視窗、 開伺服器管理、檢查更新
  • 自動更新 — 啟動時靜默檢查,GitHub Releases 簽章驗證後自動更新重啟
  • 多視窗 Popout — 面板 ⧉ 彈出為原生視窗,多螢幕交易
  • 單一實例 — 重複開啟自動聚焦既有視窗

桌面版開發:

pnpm tauri dev    # 需先放置 sidecar:src-tauri/binaries/shioaji-<target-triple>
pnpm tauri build

發佈:推 v* tag 觸發 GitHub Actions,自動建置 macOS(Intel/Apple Silicon)、 Windows、Linux 並上傳 Release 與 updater manifest。

Getting Started 開始使用(Web 版)

1. Prerequisites 前置需求

# 推薦用 uv 安裝
uv tool install shioaji
# 或下載 standalone binary,見 https://sinotrade.github.io/

2. Configure credentials 設定金鑰

cp .env.example .env
# 編輯 .env,填入你的 SJ_API_KEY / SJ_SEC_KEY

.env 已被 .gitignore 排除,請勿 commit 你的金鑰。

3. Start the Shioaji server 啟動行情/交易伺服器

shioaji server start          # 預設模擬環境(紙上交易)
shioaji server check          # 確認狀態

預設跑在 http://127.0.0.1:8080simulation 模式——下單不會動用真錢。 切正式環境:shioaji server start --production(需先完成 CA 憑證設定, 請務必先在模擬環境完整測試)。

4. Run the app 啟動前端

pnpm install
pnpm dev

開啟 http://localhost:5173 —— dev server 會把 /api 代理到 localhost:8080

Deploy as a Shioaji custom app 部署為內建 App

Shioaji server 可直接代管前端,build 完上傳即可:

VITE_BASE=/apps/shioaji-pro-app/ pnpm build
cd dist
ARGS=(); for f in *; do ARGS+=(-F "files=@$f"); done
curl -X POST http://localhost:8080/api/v1/apps/shioaji-pro-app "${ARGS[@]}"

然後開啟 http://localhost:8080/apps/shioaji-pro-app/index.html。 (注意:上傳的 app 存在 server 記憶體,server 重啟後需重新上傳。)

Safety notes 安全提醒

  • 預設為模擬環境;頂部會顯示「模擬環境」徽章,正式環境為紅色「正式環境」
  • 閃電下單預設鎖定,需手動啟用;圖表點價下單為 one-shot 模式
  • 停損/停利為客戶端觸價單,只在頁面開啟時監控
  • 正式環境的每一筆委託都是真實交易,請自行承擔風險

Stack

License

MIT

About

Shioaji Pro — professional trading terminal for Taiwan markets (TWSE/TPEX/TAIFEX) built on the Shioaji HTTP API: real-time SSE quotes, candlestick charts with click-to-trade & drag-to-reprice, flash order ladder, stop/take-profit triggers, customizable drag-and-drop workspace

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages