# Financial Metrics by Ticker/CIK (SEC-derived) > Financial Metrics by Ticker/CIK (SEC-derived) is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-27). Returns computed financial metrics per fiscal period for a company—valuation ratios, margins, returns, liquidity, leverage, and growth figures—derived from SEC filings, filterable by period type and date ranges. ## Facts - Endpoint: GET https://api.financialdatasets.ai/financial-metrics?utm_source=zero.xyz - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-10-27 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/financial-metrics-by-ticker-cik-sec-derived-79fb2537 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-IY06CLv96xFHWmXy-4Uz Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability financial-metrics-by-ticker-cik-sec-derived-79fb2537 ``` Example prompt: Pull the annual financial metrics for Apple (ticker AAPL) going back to 2019 — I need P/E, P/B, EV/EBITDA, profit margins, return on equity, and debt ratios for each year so I can compare how its valuation and profitability have changed over time. ## When to prefer this Choose this endpoint when you need computed, ready-to-use financial ratios and metrics derived from SEC filings rather than raw financial statement line items. It is ideal for valuation comparison across periods or companies, screening by profitability or leverage, and building dashboards that require ratios like P/E, EV/EBITDA, ROE, and margin percentages without computing them yourself. Prefer the real-time snapshot sibling endpoint when you need today's live market-cap-based metrics, and use the income/balance sheet/cash flow siblings when you need underlying GAAP line items. ## Known failure modes - Missing required 'period' parameter returns 400 with validation error - Unknown ticker symbol returns empty results or 404 - CIK not found in SEC database returns empty dataset - Date filter with no matching filings returns empty list - Rate limit or payment failure (x402) returns 402 Payment Required - Requesting TTM for a period with insufficient trailing data may return partial or null metrics ## How this service works Financial metrics per fiscal period for a company by ticker or CIK, computed from SEC filings: valuation (P/E, P/B, EV/EBITDA), margins, returns, liquidity, leverage, growth and per-share figures. Period annual, quarterly or ttm; filter by report_period or filing_date. Use when an agent compares valuation or profitability across periods or companies. Non-Professional use; Professional use needs a plan at financialdatasets.ai. ## Output A paginated list of financial metric records for the requested company and period type, each record containing: fiscal period label, report date, filing date, and a full suite of computed ratios including valuation multiples (P/E, P/B, EV/EBITDA, EV/Revenue), margin metrics (gross, operating, net, EBITDA margins), return metrics (ROE, ROA, ROIC), liquidity ratios (current, quick), leverage metrics (debt-to-equity, net debt/EBITDA, interest coverage), growth rates (revenue, earnings), and per-share figures (EPS, book value per share, FCF per share). Includes a next_page_url cursor for pagination. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "period" ], "properties": { "cik": { "type": "string", "description": "The Central Index Key (CIK) of the company." }, "limit": { "type": "integer", "description": "The maximum number of results to return." }, "cursor": { "type": "string", "description": "Opaque pagination cursor from a previous response's next_page_url." }, "period": { "enum": [ "annual", "quarterly", "ttm" ], "type": "string", "description": "The time period for the financial data." }, "ticker": { "type": "string", "description": "The ticker symbol of the company." }, "filing_date": { "type": "string", "description": "Filter by exact SEC filing date in YYYY-MM-DD format." }, "report_period": { "type": "string", "description": "Filter by exact report period date in YYYY-MM-DD format." }, "filing_date_gt": { "type": "string", "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format." }, "filing_date_lt": { "type": "string", "description": "Filter by SEC filing date less than date in YYYY-MM-DD format." }, "filing_date_gte": { "type": "string", "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format." }, "filing_date_lte": { "type": "string", "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format." }, "report_period_gt": { "type": "string", "description": "Filter by report period greater than date in YYYY-MM-DD format." }, "report_period_lt": { "type": "string", "description": "Filter by report period less than date in YYYY-MM-DD format." }, "report_period_gte": { "type": "string", "description": "Filter by report period greater than o … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-metrics-by-ticker-cik-sec-derived-79fb2537/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.financialdatasets.ai](https://www.zero.xyz/host/api.financialdatasets.ai/llms.txt)