SuperTrend K — 股市起漲K線 API 串接與 OpenData 服務

1. 授權帳號與 Session 模組

登入流程分析（CMoney SSO + 裝置指紋 + session token 續期）、token 保管庫、多帳號輪替。用來讓長時間運行的資料代理保持連線而不必反覆要求終端使用者重新登入，並可將同一 CMoney 帳號綁定到多個下游消費端。

2. 起漲訊號串流

擷取所有「AI 自動盯盤」的警示 — 多頭突破、區間突破、V 型反轉 — 連同底層的指標分數，以 websocket 或 webhook 形式輸出 stock_id、signal_type、score、fired_at 與 last_close。可用於快速跟單的人工交易桌，也適合用於回測訊號衰減。

3. 券商籌碼連接器

每日匯入分點層級的買賣超集中度、買超與賣超前 15 大券商，以及你匯入的券商部位。可用於「主力追蹤」儀表板、部位風險報表，並在籌碼集中度跨越門檻時觸發再平衡邏輯。

4. 長方 vs 短方多因子拉取

每檔個股的 JSON 快照，整合籌碼、價量、技術、基本四大面向 — 與 App 內長短方表格相同的四大支柱，可用於將單一「偏多 / 偏空分數」餵入專屬選股工具或 PM 儀表板。

5. 強勢「瘋狗流」選股 API

單一端點即可執行 9 強勢指標 × 6 量增指標的篩選，回傳排序後的候選清單與對應的原因代碼。常用於早盤摘要信件，並可自動把訊號送進 股市大富翁 的模擬帳戶做事前驗證。

6. 討論區與情緒掛勾

授權範圍內擷取 CMoney 投資討論區的公開貼文，依 stock_id 分群。回傳 thread title、作者 hash、發文時間與預先計算的情緒標籤，用作事件驅動模型的輔助特徵，也能在價格啟動前察覺異常的貼文量峰值。

情境 A — 量化團隊特徵管道

背景： 一支位於台北的量化基金已向富果 Market Data 採購 TWSE 逐筆，但希望能直接拿到一個現成的突破訊號特徵，不必自己重建整套指標堆疊。

資料與 API： 起漲訊號串流 + 技術指標包 + 分點籌碼集中度，正規化成統一的 signals_intraday Parquet 分區。

OpenData 對應： 與 TWSE OpenAPI、FinMind 在同一個 lakehouse 並列，透過一個 OpenFinance 風格 gateway 統一存取，每組 key 各自有速率限制與稽核紀錄。

情境 B — 家族辦公室部位鏡像

背景： 一間家族辦公室在兩家券商持有部位，希望股市起漲K線的「庫存股盯哨」鏡像 PM 們在內部工具中所看到的同一本帳。

資料與 API： 授權匯入券商持股 + 限定於既有持股的起漲訊號 webhook + 每月覆核用的 Excel 匯出端點。

OpenData 對應： 視為私有 OpenBanking 風格的「同意制資料 feed」 — 使用者授權一次，工作室 gateway 負責代理與去重。

情境 C — Roboadvisor 模型疊加

背景： 一家零售 roboadvisor 想在被動式 ETF 籃子上加一層「動能疊加」，又不想授權整套第三方訊號平台。

資料與 API： 瘋狗流選股 + 長短方多因子偏多 / 偏空分數，每晚輪詢一次。輸出灌入模型的權重微調端點。

OpenData 對應： 工作室提供薄薄一層 OpenFinance 風格 adapter（OAuth2 client credentials、JSON schema），讓 roboadvisor 的法遵團隊只需審一份合約。

情境 D — Line / Telegram 警報機器人

背景： 一家台灣付費投顧電子報希望付費訂閱者能在股市起漲K線引擎標出「瘋狗流」候選股的當下，立即收到 Line 警報。

資料與 API： 限定於約 120 檔自選股名單的起漲訊號 webhook + 對機器人友善的 REST 端點，回傳人類可讀的原因代碼。

OpenData 對應： 視為單向 OpenData 匯出 — 不回傳任何個資，僅輸出訊號中繼資料與個股層級註記。

情境 E — 跨平台研究儀表板

背景： 一位研究員同時在 富果 Fugle、富邦 e點通 與 股市起漲K線 維護自選股，需要一個統一的「我目前曝險在哪、哪一檔剛剛觸發訊號」的單一真實來源。

資料與 API： 自選股雙向同步 + 起漲訊號串流 + 一個薄薄的對帳服務，每晚比對三個來源的差異。

OpenData 對應： 以 OpenFinance 風格聚合器形式落地，每個來源各自有同意紀錄、各自有受限稽核日誌，可直接交給法遵主管覆核。

A. 授權 Session 啟動（虛擬碼）

POST /api/v1/supertrendk/session
Content-Type: application/json
X-Studio-Client: ccwork-prod

{
  "account_ref": "user_8c41",
  "device_fp": "tw-android-9f02...",
  "scope": ["signals.read", "broker.read", "watchlist.rw"]
}

200 OK
{
  "session_id": "sess_01HV...",
  "access_token": "eyJhbGciOi...",
  "expires_in": 3300,
  "refresh_after": 2400,
  "consent_record": "pdpa-2026-04-30-tw"
}

B. 起漲訊號 Webhook Payload

POST {YOUR_ENDPOINT}/supertrendk/signal
X-Signature: sha256=...
Content-Type: application/json

{
  "fired_at": "2026-04-30T05:01:18+08:00",
  "stock_id": "2330",
  "market": "TWSE",
  "signal_type": "uptrend_breakout",
  "score": 0.83,
  "indicators": {
    "strength_hits": 7,
    "volume_hits": 5
  },
  "last_close": 945.0,
  "reason_codes": ["MA20_break", "vol3x", "chip_in"]
}

C. 瘋狗流選股拉取

GET /api/v1/supertrendk/screener/maddogflow
  ?as_of=2026-04-30
  &market=TWSE,OTC
  &min_score=0.6
  &page_size=50
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "as_of": "2026-04-30",
  "items": [
    {"stock_id":"3017","score":0.91,"reasons":["KD_golden","vol_burst"]},
    {"stock_id":"6488","score":0.87,"reasons":["range_break","chip_concentration"]}
  ],
  "next_cursor": null,
  "audit_id": "aud_01HV..."
}

# 錯誤以 RFC 7807 problem+json 形式回覆，
# 穩定代碼包括：rate_limited, scope_denied, upstream_throttled。

D. Excel / JSON 對帳匯出

POST /api/v1/supertrendk/export
{
  "account_id": "user_8c41",
  "from_date": "2026-01-01",
  "to_date":   "2026-04-30",
  "datasets":  ["signals", "broker_holdings"],
  "format":    "xlsx"
}

200 OK
{
  "file_url": "https://files.example.com/...sig",
  "expires_at": "2026-04-30T08:00:00Z",
  "row_counts": {"signals": 1284, "broker_holdings": 312}
}

交付清單

• 每個端點皆附 OpenAPI 3.1 / Swagger 規格
• 協議與認證流程報告（CMoney 登入鏈、token 生命週期、限速地圖）
• 可運行原始碼：匯入代理 + gateway + 範例消費端（Python 或 Node.js）
• 訊號、券商持股、選股結果、自選股的 schema 定義
• Postman collection 與一鍵 smoke-test 腳本
• 合規包 — PDPA 對映、金管會委外重點、預設保存期限
• 運維手冊：token 輪替、錯誤代碼分類、on-call playbook

合作模式

原始碼交付（USD 300 起）： 我們交付可運行的 repo 與文件，由你自行代管。完成後、滿意再付款。適合擁有內部 SRE、想要自主握有 runtime 的團隊。

每次呼叫計費 API（無前期費用）： 直接使用我們的代管端點，按實際呼叫量付費。適合 roboadvisor、付費電子報、原型期專案 — 完全不需要 capex。

也支援混合模式 — 先用代管，量穩定後再切換到原始碼交付。

關於我們

我們是一家獨立工作室，專注於行動 App 介面分析與授權金融 API 整合。團隊曾為台灣、香港、日本、印度、巴西市場交付連接器，把逆向工程的嚴謹度與務實合規工作結合在一起。我們很清楚：量化團隊要的是 Parquet，Line 機器人經營者要的是 webhook — scoping 也會分開做。

聯絡

把目標 App 名稱、實際需要的資料點，以及希望我們使用的 sandbox / 帳號憑證寄給我們。我們會在兩個工作天內回覆 scoping 備忘錄與固定費用報價。

前往聯絡頁

合作流程

1. 需求確認 — 哪些畫面、哪些資料、要落到哪個目標系統。（1–2 個工作天）
2. 協議分析與 API 設計 — OpenAPI 規格、認證鏈、限速地圖。（2–5 個工作天）
3. 實作與內部驗證 — 匯入代理、gateway、消費端、smoke test。（3–8 個工作天）
4. 文件、範例、運維手冊 — Postman、保存期限、on-call 註記。（1–2 個工作天）
5. 交接與首次正式上線 — 端到端通常 5–15 個工作天。第三方審核（如金管會委外覆核）可能會延長時程。

常見問題

需要我提供 CMoney 帳號密碼嗎？

是否同時涵蓋上市與上櫃個股？

如果 CMoney 推出更新打壞了串接怎麼辦？

同一個 gateway 可以代理其他台股 App 嗎？