v0.2.0-beta

OpenAPI 3.1.0

获取财务指标

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

Financial Data

Company fundamentals, financial statements, market prices and economic data.

Financial Data 操作

get/v1/beta/financial/financial-metrics

获取财务指标

单个公司随时间计算的比率，每期约 49 项：market_cap、enterprise_value、price_to_earnings_ratio、price_to_book_ratio、price_to_sales_ratio、enterprise_value_to_ebitda_ratio、free_cash_flow_yield、peg_ratio、gross_margin、operating_margin、net_margin、return_on_equity、return_on_assets、return_on_invested_capital、周转率和流动性比率，每项都标注 report_period 和 fiscal_period。period 为必填；通过 ticker 或 cik 指定公司。用于观察某个比率跨期的趋势。若只需当前值，get_financial_financial_metrics_snapshot 只返回一行，体积小得多。

计费参考

计量方式：按成功请求的固定成本计费。
参考请求估算：0.02 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数

cik
类型: string

公司的 Central Index Key（CIK）。可用于替代 ticker。
cursor
类型: string

来自先前响应 next_page_url 的不透明分页游标。提供后，其他所有查询参数都会被忽略：游标携带原始请求的筛选条件。请将其视为不透明值，不要构造或修改。
filing_date
类型: string 格式: date

按 SEC 申报日期的精确值筛选，格式为 YYYY-MM-DD。没有已知申报日期的行会被排除。
filing_date_gt
类型: string 格式: date

按 SEC 申报日期晚于指定日期筛选，格式为 YYYY-MM-DD。没有已知申报日期的行会被排除。
filing_date_gte
类型: string 格式: date

按 SEC 申报日期晚于或等于指定日期筛选，格式为 YYYY-MM-DD。没有已知申报日期的行会被排除。
filing_date_lt
类型: string 格式: date

按 SEC 申报日期早于指定日期筛选，格式为 YYYY-MM-DD。没有已知申报日期的行会被排除。
filing_date_lte
类型: string 格式: date

按 SEC 申报日期早于或等于指定日期筛选，格式为 YYYY-MM-DD。适用于时点查询：仅返回截至该日期已公开申报的数据。没有已知申报日期的行会被排除。
limit
类型: integer

要返回的最大结果数。这是所有页面的总数，而不是页大小：每页最多包含 10 条记录，并通过 next_page_url 链接。
period
类型: string 枚举
必填

财务数据的时间段。
值
- annual
- quarterly
- ttm
report_period
类型: string 格式: date

按报告期日期的精确值筛选，格式为 YYYY-MM-DD。
report_period_gt
类型: string 格式: date

筛选报告期大于 YYYY-MM-DD 格式的日期。
report_period_gte
类型: string 格式: date

筛选报告期大于或等于 YYYY-MM-DD 格式的日期。
report_period_lt
类型: string 格式: date

筛选报告期小于 YYYY-MM-DD 格式的日期。
report_period_lte
类型: string 格式: date

筛选报告期小于或等于 YYYY-MM-DD 格式的日期。
ticker
类型: string

公司的股票代码。未提供 cik 时必填。

响应

200
类型: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

某只 ticker 的历史财务指标与比率
accession_number
类型: string | null

申报文件的 SEC accession number。

asset_turnover
类型: number

营收除以平均总资产。

book_value_growth
类型: number

账面价值的同比增长。

book_value_per_share
类型: number

股东权益除以流通在外股数。

cash_ratio
类型: number

现金及现金等价物除以流动负债。

currency
类型: string

财务数据的报告货币。

current_ratio
类型: number

流动资产除以流动负债。

days_sales_outstanding
类型: number

期间平均应收账款除以营收。

debt_to_assets
类型: number

总债务除以总资产。

debt_to_equity
类型: number

总债务除以股东权益。

earnings_growth
类型: number

盈利的同比增长。

earnings_per_share
类型: number

净利润除以加权平均流通在外股数。

earnings_per_share_growth
类型: number

期间内每股收益的增长。

ebitda_growth
类型: number

期间内 EBITDA 的增长。

enterprise_value
类型: number

公司的总价值（市值 + 债务 - 现金）。

enterprise_value_to_ebitda_ratio
类型: number

企业价值与 EBITDA 之比。

enterprise_value_to_revenue_ratio
类型: number

企业价值与营收之比。

filing_date
类型: string | null 格式: date

SEC 受理申报的日历日，采用美国东部时间（SEC 的运营时区）。与 filing_datetime 配对的日历日。当该行未关联任何带日期的 SEC 申报文件时为 null。

filing_datetime
类型: string | null 格式: date-time

记录 SEC 受理申报的日内时间戳，采用美国东部时间。取自 SEC EDGAR submissions API 上的 acceptanceDateTime 字段。与 filing_date 配对（同一事件的日历日精度）。

filing_url
类型: string | null 格式: uri

SEC 申报文件的 URL。

fiscal_period
类型: string

财务指标的会计期间。

form_type
类型: string | null

该行数据来源的 SEC 表格（10-K、10-Q/A、20-F、S-1……）。这是申报时实际提交的表格，因此修正版会保留 /A 后缀。当 period 为 ttm 时为 null：十二个月滚动窗口可能跨越多个申报文件，因此不会归到某一个。当第四季度由财年申报文件推导而来时，quarterly 行也可能带有 10-K。

free_cash_flow_growth
类型: number

期间内自由现金流的增长。

free_cash_flow_per_share
类型: number

自由现金流除以流通在外股数。

free_cash_flow_yield
类型: number

自由现金流收益率。

gross_margin
类型: number

毛利占营收的百分比。

interest_coverage
类型: number

EBIT 除以利息支出。

inventory_turnover
类型: number

销货成本除以平均存货。

net_margin
类型: number

净利润占营收的百分比。

next_page_url
类型: string

下一页结果的绝对 URL。仅在还有更多结果时出现；按原样请求即可继续。每页最多 10 条记录。

operating_cash_flow_ratio
类型: number

经营现金流除以流动负债。

operating_cycle
类型: number

存货周转率 + 应收账款周转率。

operating_income_growth
类型: number

期间内营业利润的增长。

operating_margin
类型: number

营业利润占营收的百分比。

payout_ratio
类型: number

已付股息占净利润的百分比。

peg_ratio
类型: number

市盈率相对盈利增长比率。

period
类型: string 枚举

财务指标的时间段。

值
quarterly
ttm
annual
price_to_book_ratio
类型: number

市净率。

price_to_earnings_ratio
类型: number

市盈率。

price_to_sales_ratio
类型: number

市销率。

quick_ratio
类型: number

速动资产除以流动负债。

receivables_turnover
类型: number

营收除以平均应收账款。

report_period
类型: string 格式: date

财务指标的报告期。

return_on_assets
类型: number

净利润占总资产的百分比。

return_on_equity
类型: number

净利润占股东权益的百分比。

return_on_invested_capital
类型: number

税后净营业利润占投入资本的百分比。

revenue_growth
类型: number

营收的同比增长。

ticker
类型: string

公司的 ticker 代码。

working_capital_turnover
类型: number

营收除以平均营运资金。
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

get/v1/beta/financial/financial-metrics

curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

{
  "ticker": "string",
  "report_period": "2026-10-26",
  "fiscal_period": "string",
  "period": "quarterly",
  "currency": "string",
  "accession_number": null,
  "form_type": null,
  "filing_url": null,
  "filing_date": null,
  "filing_datetime": null,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}

某只 ticker 的历史财务指标与比率

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

获取财务指标

身份验证Required

Financial Data

获取财务指标

计费参考

需要帮助？