Important
這是社群維護的 AI skill，不是富邦官方 SDK。交易程式上線前，請以官方文件、測試環境與券商回報為最終依據。
它把散落在官方文件、測試環境經驗與實務專案裡的 NeoAPI 知識，整理成 AI 可以穩定遵循的工作流程。
| 能力 | 內容 |
|---|---|
| 交易流程 | 登入、選帳號、下單、改單、刪單、成交回報與對帳 |
| 行情資料 | HTTP 快照、歷史行情、WebSocket 訂閱與訊息 envelope |
| 安全護欄 | 測試／正式環境分流、價格來源、股數單位、版本相容性 |
| 遷移協助 | 將既有 Shioaji 程式逐步移植到 Fubon NeoAPI |
| 離線文件 | 內建繁中／英文 llms*.txt 快照，斷線時仍可查詢 |
git clone https://github.com/phenomenoner/neoapi-skill.git
cd neoapi-skill
.\update-skill.ps1git clone https://github.com/phenomenoner/neoapi-skill.git
cd neoapi-skill
bash ./update-skill.sh預設會安裝到 ~/.codex/skills/public/neoapi-python。完成後重啟 Codex 或其他支援本地 skill 的代理；自訂路徑與手動安裝方式請見 INSTALL.md。
| 情境 | 正確做法 |
|---|---|
| 測試環境判斷可下單價格 | 使用 sdk.stock.query_symbol_quote(account, symbol) |
| 正式行情查漲跌停 | 使用 intraday.ticker；intraday.quote 偏成交行情 |
| 取消單仍出現在查詢結果 | get_order_results 的 status 30 代表已刪單 |
| 訂單數量 | 一律填「股數」，不是張數；1 張 = 1000 股 |
| 即時成交 | set_on_filled 為主路徑，get_order_results 作週期性 safe-net |
| 預設憑證密碼 | SDK >= 1.3.2 省略 login 第 4 參數，不傳空字串 |
| WebSocket 零價格 | 搭配 isLimitUp* / isLimitDown* 旗標解碼，不比對 "市價" |
| Python 版本 | 官方目前支援 3.8–3.13；不支援 3.14 |
使用者問題
└─ 官方 llms.txt：快速找到正確頁面
└─ 官方頁面 .txt / llms-full.txt：核對參數與範例
└─ bundled llms*.txt：離線 fallback
└─ references/：測試環境與實務補充
線上官方文件永遠優先；bundle 內的四份 llms*.txt 是離線快照。本版於 2026-07-17 重新抓取，官方伺服器回報 Last-Modified: 2026-05-07。
.
├─ skills/neoapi-python/
│ ├─ SKILL.md # AI 的主入口與決策規則
│ ├─ references/ # 測試環境、回傳格式、實作指南
│ ├─ llms*.txt # 官方文件離線快照（zh/en）
│ ├─ VERSION # skill 版本
│ └─ neoapi-python.skill # 本地建立的可攜式 ZIP bundle（git ignored）
├─ AGENTS.md / CLAUDE.md / GEMINI.md
├─ update-skill.ps1 / update-skill.sh
└─ .test/ # 維護者本地整合測試（不隨 bundle 發佈）
文件或 skill 規則更新時：
- 同步四個官方 zh/en
llms*.txt端點。 - 更新
SKILL.md、VERSION、references 與三份 adapter。 - 重建
neoapi-python.skill，檢查封裝內容與版本一致。 - 依變更風險執行靜態檢查或
.test/test_runner.py整合套件。
本次 v1.0.0-beta.32 修正預設憑證登入與 WebSocket 零價格／漲跌停旗標判讀，對應 Issues #1、#2。完整歷程請見 CHANGELOG.md。