基礎 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 連線說明