申請資料或分析

告訴我們你需要卻沒有找到的內容。申請會在每週審閱中被閱讀並與相似申請合併，在公開來源允許的範圍內，被請求最多的資料會最先建置。

何時申請

當你需要的資料集、欄位、公司或分析缺漏，或某個結果看起來有誤時，就送出申請。使用者使用表單，智能體使用 API 或 MCP 伺服器。兩者進入同一佇列，限額相同。

終端裡每個空結果、未涵蓋和未知公司的提示末尾都有一個「申請它」連結，會替你預填表單。命令面板中也有「申請資料或分析」。

類型

類型	適用於
`dataset`	我們缺少的整個資料集
`field`	某個科目或屬性
`analysis`	你不得不手動完成的計算
`coverage`	我們尚未涵蓋的公司、交易所或國家
`bug`	錯誤或失效的結果
`other`	其他

使用表單

申請資料或分析表單需要填寫類型、你需要什麼、原因（選填）和公司（選填）。請勿在文字中填寫個人資料。

你會立即取得一個申請編號，請保存它以便之後查詢狀態。

透過 API 送出

POST /v1/request-data 需要 kind 和 want，可選填 why、company 和 endpoint_or_tool。無需金鑰，從不收費。

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" \
  -d '{"kind":"dataset","want":"Segment operating margin by quarter","why":"Comparing business lines","company":"ticker:AAPL"}'

回應為 201，包含申請編號、所併入的需求項目、其狀態以及目前的申請次數：

{
  "data": {
    "request_id": "0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "item_id": "7c2e0d4b-31a9-4f57-9a3e-5d0b8c1f2a64",
    "status": "new",
    "requests": 3,
    "requesters": 2,
    "status_url": "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "served_by": null
  },
  "meta": { ... }
}

每個位址每個 UTC 日最多 10 筆申請，總計 500 筆。超過任一限額會回傳 429 並附帶 Retry-After（見 rate_limited）。GET /v1/request-data 說明了請求主體。

透過智能體送出

MCP 伺服器為此提供兩個工具：request_data 用相同的欄位送出申請，request_status 按編號查詢。API 未能滿足需求的結果帶有類型為 request_data 的補救項目，讓智能體不會卡住。

https://mcp.financial.md/mcp

追蹤狀態

相似的申請按類型、公司和概念合併為一個需求項目，重複申請會增加一票。可在狀態頁或用 GET /v1/request-data/{id} 查詢：

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

狀態	含義
`new`	已收到，尚未審閱
`triaged`	已審閱並與類似申請合併
`planned`	我們打算建置它
`done`	已建置；`served_by` 指出提供它的路由或工具
`wontfix`	我們不會建置它；公開備註說明原因

申請與上線

申請與上線頁面列出經我們人工審閱並命名的需求項目及其計數和結果。需求項目不會被自動列出。只顯示彙總資料：沒有申請者，也沒有提交的原文。同樣的資料也以 JSON 資料來源提供：

curl "https://api.financial.md/v1/requested"

更新日誌連結到這個頁面，每個已上線的項目都註明了提供方式。

我們能建置什麼

我們基於免費的公開來源和自己的衍生分析來建置：

SEC EDGAR 申報文件和資料集（報表、持股、事件、基金）
FRED 及其他公開統計資料
基於已提供資料的計算（比率、篩選、比較）

需要授權或條款禁止再利用的資料，例如市場共識預估、分析師評級或即時交易所行情，會標記為 wontfix，並附上指向 GET /v1/coverage 的備註。之後對這些資料的申請仍計為投票，讓我們知道需求所在。

隱私

申請不需要任何個人資料。你的傳送地址只以加鹽摘要的形式保存，用於執行限額。

表單目前不要求提供電子郵件地址：請用申請編號查詢進度。今後若提供回覆電子郵件功能，該功能為選用，只有勾選後才會寄送；電子郵件地址會與申請分開保存，僅用於通知你申請的資料已上線或申請已結案，在申請結案時或 365 天後刪除，且絕不分享。請參閱隱私。