錯誤說明
每個錯誤回應本文都有 code、一句直白的 message、request_id 和 remedies 清單。docs 欄位連結到本頁對應的錯誤碼條目。
invalid_request (400)
缺少參數或參數格式不正確。錯誤訊息會指出是哪個參數。修正請求後重新傳送。
unauthorized (401)
請求所帶的 API 金鑰格式不正確、已被撤銷,或缺少該路由需要的權限。所有資料路由不帶金鑰也能使用:移除 Authorization 請求標頭即可使用無金鑰限額。金鑰尚未公開發放,見 API 金鑰。
payment_required (402)
只有主機 agent.financial.md 會回傳這個錯誤。該主機上的計價路由需要付款:PAYMENT-REQUIRED 回應標頭提供價格和條件。用 x402 付款後重新呼叫,或在 api.financial.md 上不帶金鑰呼叫同一路由(受每日限額約束)。見價格。
unknown_company (404)
沒有公司與 company 參數相符。可以改用 CIK(cik:320193),或用 GET /v1/companies?q= 搜尋。已下市的公司不能按股票代號查找,請使用其 CIK。GET /v1/companies?status=delisted 可列出這些公司。
unknown_concept (404)
該概念或比率識別碼不在公司的範本中。GET /v1/company/metrics 列出可用的識別碼。
not_found (404)
路徑、申報文件或證據識別碼不存在。請檢查申報編號或證據識別碼。
not_covered (404)
公司已收錄,但沒有這個資料集。回應本文中列出 available_datasets。按 IFRS 申報的公司有申報文件,但暫時沒有標準化報表。
rate_limited (429)
這一類路由的每日限額已用完。請等待 Retry-After 提供的秒數。限額見文件頁。更高限額的金鑰尚未發放。
upstream_unavailable (503)
API 無法連接資料庫。請稍等後重試。request_id 能幫助我們找到這次呼叫。