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/financials

获取全部财务报表

一次调用获取单个公司的全部三张报表。返回一个 financials 对象，包含 income_statements、balance_sheets 和 cash_flow_statements，每张的结构与专用工具返回的相同。period 为必填（annual、quarterly 或 ttm）；通过 ticker 或 cik 指定公司，并用 limit 限制数量。当你需要全貌、否则要调用三次时使用它。若只需一张报表，get_financial_financials_income_statements、get_financial_financials_balance_sheets 或 get_financial_financials_cash_flow_statements 返回的数据少得多；若需跨多家公司获取少量指定字段，post_financial_financials_search_line_items 的范围更窄。

计费参考

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

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

查询参数

cik
类型: string

公司的 Central Index Key（CIK）。
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 格式: int32

要返回的最大财务报表数。这是所有页面的总数，而不是页大小：每页最多包含 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_FinancialsResponse

财务报表响应
financials
类型: object
balance_sheets
类型: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
accession_number
类型: string | null

申报文件的 SEC accession number。

accumulated_other_comprehensive_income
类型: number

公司的累计其他综合收益。

cash_and_equivalents
类型: number

公司的现金及等价物。

currency
类型: string

财务数据的报告货币。

current_assets
类型: number

公司的流动资产。

current_debt
类型: number

公司的短期债务。

current_investments
类型: number

公司的流动投资。

current_liabilities
类型: number

公司的流动负债。

deferred_revenue
类型: number

公司的递延收入。

deposit_liabilities
类型: 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。

goodwill_and_intangible_assets
类型: number

公司的商誉及无形资产。

inventory
类型: number

公司的存货。

investments
类型: number

公司的投资。

non_current_assets
类型: number

公司的非流动资产。

non_current_debt
类型: number

公司的非流动债务。

non_current_investments
类型: number

公司的非流动投资。

non_current_liabilities
类型: number

公司的非流动负债。

outstanding_shares
类型: number

公司的流通在外股数。

period
类型: string 枚举

资产负债表的时间段。

值
quarterly
ttm
annual
property_plant_and_equipment
类型: number

公司的不动产、厂房及设备。

report_period
类型: string 格式: date

资产负债表的报告期。

retained_earnings
类型: number

公司的留存收益。

shareholders_equity
类型: number

公司的股东权益。

tax_assets
类型: number

公司的税务资产。

tax_liabilities
类型: number

公司的税务负债。

ticker
类型: string

股票代码。

total_assets
类型: number

公司的总资产。

total_debt
类型: number

公司的总债务。

total_liabilities
类型: number

公司的总负债。

trade_and_non_trade_payables
类型: number

公司的应付账款及非贸易应付款。

trade_and_non_trade_receivables
类型: number

公司的应收账款及非贸易应收款。

cash_flow_statements
类型: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
accession_number
类型: string | null

申报文件的 SEC accession number。

business_acquisitions_and_disposals
类型: number

公司的业务收购与处置。

capital_expenditure
类型: number

公司的资本支出。

change_in_cash_and_equivalents
类型: number

公司的现金及等价物变动。

currency
类型: string

财务数据的报告货币。

depreciation_and_amortization
类型: number

公司的折旧与摊销。

dividends_and_other_cash_distributions
类型: number

公司的股息及其他现金分配。

effect_of_exchange_rate_changes
类型: number

公司的汇率变动影响。

ending_cash_balance
类型: 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
类型: number

公司的自由现金流。

investment_acquisitions_and_disposals
类型: number

公司的投资收购与处置。

issuance_or_purchase_of_equity_shares
类型: number

公司的股权发行或回购。

issuance_or_repayment_of_debt_securities
类型: number

公司的债务证券发行或偿还。

net_cash_flow_from_financing
类型: number

公司的融资活动净现金流。

net_cash_flow_from_investing
类型: number

公司的投资活动净现金流。

net_cash_flow_from_operations
类型: number

公司的经营活动净现金流。

net_income
类型: number

公司的净利润。

period
类型: string 枚举

现金流量表的时间段。

值
quarterly
ttm
annual
report_period
类型: string 格式: date

现金流量表的报告期。

share_based_compensation
类型: number

公司的股份支付薪酬。

ticker
类型: string

股票代码。

income_statements
类型: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
accession_number
类型: string | null

申报文件的 SEC accession number。

consolidated_income
类型: number

公司的合并收益。

cost_of_revenue
类型: number

公司的营收成本。

currency
类型: string

财务数据的报告货币。

dividends_per_common_share
类型: number

公司的每股普通股股息。

earnings_per_share
类型: number

公司的每股收益。

earnings_per_share_diluted
类型: number

公司的稀释每股收益。

ebit
类型: 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。

gross_profit
类型: number

公司的毛利。

income_tax_expense
类型: number

公司的所得税费用。

interest_expense
类型: number

公司的利息支出。

net_income
类型: number

公司的净利润。

net_income_common_stock
类型: number

公司的普通股股东可获得的净利润。

net_income_discontinued_operations
类型: number

公司的终止经营净利润。

net_income_non_controlling_interests
类型: number

公司的非控股权益净利润。

operating_expense
类型: number

公司的营业费用。

operating_income
类型: number

公司的营业利润。

period
类型: string 枚举

利润表的时间段。

值
quarterly
ttm
annual
preferred_dividends_impact
类型: number

优先股股息对公司净利润的影响。

report_period
类型: string 格式: date

利润表的报告期。

research_and_development
类型: number

公司的研发费用。

revenue
类型: number

公司的总营收。

selling_general_and_administrative_expenses
类型: number

公司的销售、一般及管理费用。

ticker
类型: string

股票代码。

weighted_average_shares
类型: number

公司的加权平均股数。

weighted_average_shares_diluted
类型: number

公司的稀释加权平均股数。

next_page_url
类型: string

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

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

需要有效的 Felo API 密钥。
402

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

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

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

服务无法完成该请求。
503

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

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

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

application/json

get/v1/beta/financial/financials

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

显示 Schema

{
  "financials": {
    "income_statements": [
      {
        "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,
        "revenue": 1,
        "cost_of_revenue": 1,
        "gross_profit": 1,
        "operating_expense": 1,
        "selling_general_and_administrative_expenses": 1,
        "research_and_development": 1,
        "operating_income": 1,
        "interest_expense": 1,
        "ebit": 1,
        "income_tax_expense": 1,
        "net_income_discontinued_operations": 1,
        "net_income_non_controlling_interests": 1,
        "net_income": 1,
        "net_income_common_stock": 1,
        "preferred_dividends_impact": 1,
        "consolidated_income": 1,
        "earnings_per_share": 1,
        "earnings_per_share_diluted": 1,
        "dividends_per_common_share": 1,
        "weighted_average_shares": 1,
        "weighted_average_shares_diluted": 1
      }
    ],
    "balance_sheets": [
      {
        "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,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_statements": [
      {
        "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,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}

财务报表响应

需要帮助？

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

获取全部财务报表

身份验证Required

Financial Data

获取全部财务报表

计费参考

需要帮助？