覆盖范围分散
您的书涵盖了美国、欧盟、亚洲和海湾合作委员会的发行人——每个发行人都有自己的监管门户、备案格式和披露滞后。在-house 中将其拼接在一起意味着每个市场一个抓取器和每个分类法一个解析器。
对于对冲基金
62 监管源标准化为一个跨 GAAP KPI 分类法,并带有签名的 webhook,当文件进入您的监视列表时就会触发 — 无需抓取工具,无需 PDF 解析器,无需每晚维护批次。
pip install openfilings 并在一个下午连接您的第一个处理程序。
问题
您的书涵盖了美国、欧盟、亚洲和海湾合作委员会的发行人——每个发行人都有自己的监管门户、备案格式和披露滞后。在-house 中将其拼接在一起意味着每个市场一个抓取器和每个分类法一个解析器。
10-K、Yūho、DART、MOPS 和 ESEF 年报对“收入”的表述都不同。 Without 标准化、跨市场筛选和因子模型运行的数字实际上无法比较。
一旦发行人修改备案文件,提取一次并缓存的 KPI 就会失效。时间点的正确性对于回测和任何涉及实时头寸的事情都很重要。
你得到什么
文件直接从 SEC EDGAR、EDINET、OpenDART、MOPS、ESEF、Companies House 等 62 市场的监管源中提取,并带有返回到每条记录上的原始文档的链接。
收入、利润率、每股收益和同比增量标准化为跨市场和会计标准的一种分类法——查询一个行项目代码,而不是自己解析每种披露格式。
注册一次URL;您的监视列表上的新文件、新闻稿和内幕交易会以 HMAC 签名的 POST 形式出现 — 无轮询循环,可仅通过标准库进行验证。
管道
01
search_ticker /Entity.search 将名称、股票代码、LEI 或 ISIN 解析为一个规范发行人 — 在假设单一市场之前阅读Entity.listings[]。
02
get_company_financials 在一次调用中提取一个多年期系列,其中包含 fiscal_year_from/to 和 line_items 过滤器 - 标准 KPI 回填没有每个归档循环。
03
创建一次 webhook (event_types=["filing.discovered"]);您的观察列表中的每一项新披露都会在几秒钟内签署,而不是每晚进行民意调查。
04
verify_webhook() 使用 hmac.compare_digest 检查签名,然后 GET /api/v1/filings/{id}/kpis / get_filing_section 水合您的信号需要从该 file_id 获取的任何内容。
一体化
交付通过原始请求正文使用 HMAC-SHA256 进行签名 - verify_webhook() 除了 Python 标准库之外不需要任何东西。
handler.py · FastAPI
import os
from fastapi import Depends, FastAPI
from openfilings import Client
from openfilings.integrations.fastapi import openfilings_webhook_dependency
from openfilings.webhooks import WebhookEvent
app = FastAPI()
client = Client(api_key=os.environ["OPENFILINGS_API_KEY"])
verify = openfilings_webhook_dependency(os.environ["OPENFILINGS_WEBHOOK_SECRET"])
@app.post("/openfilings-webhook")
async def on_filing(event: WebhookEvent = Depends(verify)) -> dict:
if event.event == "filing.discovered":
kpis = client.filings.kpis(event.data["filing_id"])
# ... run your signal against kpis.canonical ...
print(event.data["ticker"], kpis.canonical.get("revenue"))
return {"ok": True}filing.discovered payload
{
"event": "filing.discovered",
"version": "1",
"timestamp": "2026-08-08T09:14:02.331Z",
"data": {
"canonical_key": "sec:0000320193",
"ticker": "AAPL",
"market_id": "us",
"form_type": "10-Q",
"filing_id": "3f1b7e2a-...",
"filing_date": "2026-08-08"
}
}现场报道
获取访问权限
粘贴您所涵盖的代码或 ISIN 以及您正在构建的内容 — 数据工程主管将跟进 API 访问、您市场的覆盖范围详细信息以及 webhook 交付的业务计划条款。
常问问题
OpenFilings 是主要来源备案和规范 KPI 层,而不是市场数据终端 - 没有定价,没有共识估计。它旨在与您现有的监管事件和基本面数据堆栈相邻:提交的内容、时间以及标准化数据的内容。
对于 RSS/流原生市场,从发现到可查询通常需要不到 60 秒; webhook 在持久化后立即触发,因此您的处理程序会在大多数标题聚合器发布摘要之前看到该事件。
签名的 webhook 交付是一项商业计划功能(请参阅/定价)。 REST API 和 Python SDK 适用于每个付费计划; webhooks 在轮询之上添加推送层。
或者 - pip install openfilings 使用类型化模型、自动 429 退避和仅 stdlib 的 verify_webhook() 帮助程序包装相同的 REST API。每个 SDK 响应还公开了我们尚未包装的字段的 .raw / .to_dict() 。
每个文件的披露行项目在解析时映射到共享分类法 (GET /api/v1/kpi-taxonomy / client.companies.kpi_taxonomy()),因此来自 US 10-K、Yūho 和 ESEF 年度报告的收入可以作为相同的 line_items 代码进行查询。
KPI 根据修改后的备案重新导出,并且 API 默认提供最新值;当您需要时间点值时,get_company_financials 接受 as_of 参数。