错误说明
每个错误响应都有 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= 搜索。目前覆盖现在在美国交易所上市的 SEC 申报公司,已退市的公司尚未收录。
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 能帮助我们找到这次调用。