Tool HTTP API 入門

基礎 URL

https://<您的網域>/api/tools/v1/

認證

請求需擇一帶入憑證：

X-Finance-Tools-Api-Key: ft_...

或：

Authorization: Bearer ft_...

或使用 Firebase ID token / MCP OAuth token（詳見開發者概覽）。

未帶有效憑證時回傳 401。

回應格式

成功：200，{ "data": { … } }
失敗：{ "error": { "message", "code", "details" } }

常用端點

| 方法 | 路徑 | 說明 | |------|------|------| | POST | /loan/calculate | 房貸／貸款試算 | | POST | /compound/calculate | 複利試算 | | POST | /break-even/calculate | 損益平衡 | | POST | /dca/calculate | 定期定額試算 | | POST | /leverage/calculate | 槓桿安全水位 | | GET | /financial-summary | 財務摘要（需登入或有效 Key 綁定使用者） |

範例（房貸試算）

curl -sS -X POST "https://<網域>/api/tools/v1/loan/calculate" \
  -H "X-Finance-Tools-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"input\":{\"loanAmount\":1000000,\"annualRate\":2.5,\"loanTerm\":20,\"repaymentMethod\":\"equal-payment\",\"loanType\":\"mortgage\"}}"

POST 請求請帶 Content-Type: application/json（GET 除外）。

下一步

建立 API Key：API Key 與用量
MCP 設定：登入後於設定頁查看 MCP 連線說明

常用端點

範例（房貸試算）

curl -sS -X POST "https://<網域>/api/tools/v1/loan/calculate" \ -H "X-Finance-Tools-Api-Key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d "{\"input\":{\"loanAmount\":1000000,\"annualRate\":2.5,\"loanTerm\":20,\"repaymentMethod\":\"equal-payment\",\"loanType\":\"mortgage\"}}"

POST 請求請帶 Content-Type: application/json（GET 除外）。