跳到正文

申请数据或分析

告诉我们你需要却没有找到的内容。申请会在每周审阅中被阅读并与相似申请合并,在公开来源允许的范围内,被请求最多的数据会最先构建。

何时申请

当你需要的数据集、字段、公司或分析缺失,或某个结果看起来有误时,就发送申请。用户使用表单,智能体使用 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 天后删除,绝不分享。见隐私。