Financial Data
Company fundamentals, financial statements, market prices and economic data.
获取 SEC 备案文件项目
一条 SEC 备案文件中编号项目的全文。ticker、filing_type（10-K、10-Q 或 8-K）和 year 均为必填；可用 quarter、item、accession_number 或 include_exhibits 进一步收窄范围。返回 items——每项包含 number、title 和完整的 text——以及 filing_url 和 accession_number。注意数据量：一份 10-K 会返回约 19 个完整的散文项目，因此除非确实需要整份文档，请请求特定的 item，而不要拉取全部内容。若要先确定该打开哪份备案文件，请用 get_financial_filings。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.02 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: stringaccession
_number 若为 8-K，则为申报文件的 accession number。
- 类型: string 枚举filing
_type 必填申报文件类型。
值- 10
- K - 10
- Q - 8
- K
- 类型: booleaninclude
_exhibits 是否包含来自关联附件的原始文本。仅适用于 8-K 申报文件。为 true 时，附件对象将包含 'text' 字段，其中含有完整的附件内容。
- 类型: string 枚举item
要获取的项目。
值- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- 类型: integerquarter
若为 10-Q，则为申报文件所属季度。
- 类型: stringticker必填
股票代码。
- 类型: integeryear必填
申报文件所属年份。
- 类型: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
SEC 备案文件项目响应
- 类型: stringaccession
_number 申报文件的 accession number。
- 类型: stringcik
公司的 Central Index Key（CIK）。
- 类型: stringfiling
_type 申报文件类型。
- 类型: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibits类型: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
链接到该条目的附件数组。仅当附件存在时针对 8-K 申报文件提供。
- description类型: string
附件的说明。
- number类型: string
附件编号（例如 '99.1'）。
- text类型: string
附件的原始文本内容。仅当 'include_exhibits' 参数设为 true 时包含。
- url类型: string 格式: uri
SEC 网站上该附件文档的 URL。
- name类型: string
条目名称。
- number类型: string
条目编号。
- text类型: string
条目文本。
- 类型: integerquarter
申报文件所属的季度。
- 类型: stringresource
资源类型标识符。
- 类型: stringticker
公司的 ticker 代码。
- 类型: integeryear
申报文件所属年份。
application/json - 类型: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
备案文件仍在准备中。请轮询响应体中的 result_url 获取结果。此响应不计费。
- 类型: stringaccession
_number 正在准备的申报文件的 accession number。
- 类型: string 格式: date-timeestimated
_ready _at 申报文件预计就绪的时间。
- 类型: stringmessage
下一步操作的人类可读说明。
- 类型: string 格式: uuidrequest
_id 本次请求的标识符；联系支持时有用。
- 类型: stringresult
_url 用于轮询结果的 URL。
- 枚举status常量:processing
202 响应时始终为 'processing'。
值- processing
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}