Financial Data
Company fundamentals, financial statements, market prices and economic data.
搜索财务报表
查找符合数值条件的 ticker。请求体接收 filters——每项包含 field、operator 和 value——以及 limit。返回 results，包含 ticker、currency、sector、industry 以及所匹配的筛选字段。这是此处唯一无需预先知道 ticker 即可使用的工具；其他工具都需要输入 ticker。可筛选字段即 get_financial_financial_metrics 返回的指标名称。可用它构建候选列表，再用报表或指标工具逐一获取详情。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.02 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array object[] 1…filters必填
要应用到搜索的筛选对象数组。
- field类型: string必填
筛选条件。对于财务指标字段，请使用 'gt'、'lt'、'gte'、'lte'、'eq' 运算符。对于 'ticker' 和 'cik' 字段，请使用 'in' 运算符对多个值进行筛选。
- operator类型: string 枚举必填
比较运算符。'in' 运算符只能用于字段值为 'ticker' 或 'cik' 的情况，可对多个值进行筛选。
值- gt
- lt
- gte
- lte
- eq
- in
- value必填
- 类型: number
单值运算符（gt、lt、gte、lte、eq）的比较值
- 类型: integerlimit最小值:1
要返回的最大结果数。
- 类型: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
搜索成功响应
- 类型: array object[]search
_results - currency类型: string
财务数据的货币。
- period类型: string 枚举
财务数据的时间段。
值- annual
- quarterly
- ttm
- report类型: string 格式: date
_period 财务数据的报告期。
- ticker类型: string
公司的 ticker 代码。
- property类型: string
Name 基于搜索条件的其他财务指标。
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/financial/financials/search/screener \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"limit": 10,
"filters": [
{
"field": "",
"operator": "gt",
"value": 1
}
]
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}