Skip to main content
GET
Get 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 只返回一行,数据量小得多。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

费用与请求规则

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.02
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

cik
string

公司的中央索引键(CIK)。可代替 ticker 使用。

cursor
string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

filing_date
string<date>

Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gt
string<date>

Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gte
string<date>

Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_lt
string<date>

Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_lte
string<date>

Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.

limit
integer

The maximum number of results to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

period
enum<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,则此项为必填。

响应

某个 ticker 的历史财务指标和比率

ticker
string

公司的股票代码。

report_period
string<date>

The reporting period of the financial metrics.

fiscal_period
string

The fiscal period of the financial metrics.

period
enum<string>

The time period of the financial metrics.

可用选项:
quarterly,
ttm,
annual
currency
string

财务数据的报告币种。

accession_number
string | null

The SEC accession number of the filing.

form_type
string | null

The SEC form this row was sourced from (10-K, 10-Q/A, 20-F, S-1, ...). The exact form as filed, so amendments keep their /A suffix. Null when period is ttm: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A quarterly row can carry 10-K when the fourth quarter is derived from the fiscal-year filing.

filing_url
string<uri> | null

SEC 申报文件的 URL。

filing_date
string<date> | null

Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to filing_datetime. Null when no dated SEC filing is linked to the row.

filing_datetime
string<date-time> | null

Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's acceptanceDateTime field on the EDGAR submissions API. Pairs with filing_date (calendar-day precision of the same event).

enterprise_value
number

公司的总价值(市值 + 债务 - 现金)。

price_to_earnings_ratio
number

市盈率。

price_to_book_ratio
number

市净率。

price_to_sales_ratio
number

市销率。

enterprise_value_to_ebitda_ratio
number

企业价值与 EBITDA 的比率。

enterprise_value_to_revenue_ratio
number

企业价值与营收之比。

free_cash_flow_yield
number

自由现金流收益率。

peg_ratio
number

市盈增长比率。

gross_margin
number

毛利润占营收的百分比。

operating_margin
number

营业收入占营收的百分比。

net_margin
number

净利润占收入的百分比。

return_on_equity
number

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

return_on_assets
number

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

return_on_invested_capital
number

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

asset_turnover
number

营收除以平均总资产。

inventory_turnover
number

销售成本除以平均存货。

receivables_turnover
number

收入除以平均应收账款。

days_sales_outstanding
number

该期间的平均应收账款除以收入。

operating_cycle
number

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

working_capital_turnover
number

收入除以平均营运资本。

current_ratio
number

流动资产除以流动负债。

quick_ratio
number

速动资产除以流动负债。

cash_ratio
number

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

operating_cash_flow_ratio
number

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

debt_to_equity
number

总债务除以股东权益。

debt_to_assets
number

总债务除以总资产。

interest_coverage
number

EBIT 除以利息支出。

revenue_growth
number

营收同比增长率。

earnings_growth
number

盈利同比增长率。

book_value_growth
number

账面价值同比增长率。

earnings_per_share_growth
number

该期间内每股收益的增长。

free_cash_flow_growth
number

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

operating_income_growth
number

该期间的营业利润增长额。

ebitda_growth
number

期内 EBITDA 增长。

payout_ratio
number

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

earnings_per_share
number

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

book_value_per_share
number

股东权益除以流通股数。

free_cash_flow_per_share
number

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

next_page_url
string

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.