{"uid":"cap_-IY06CLv96xFHWmXy-4Uz","slug":"financial-metrics-by-ticker-cik-sec-derived-79fb2537","name":"Financial Metrics by Ticker/CIK (SEC-derived)","description":"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.","url":"https://api.financialdatasets.ai/financial-metrics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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 or equal to date in YYYY-MM-DD format."},"report_period_lte":{"type":"string","description":"Filter by report period less than or equal to date in YYYY-MM-DD format."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_edMX0tJ8qrPlylcrNK3GC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Sector valuation comparison across companies","prompt":"Get the most recent quarterly P/E, P/B, and EV/EBITDA ratios for Microsoft, Google, and Meta so I can see which one looks cheapest on a valuation basis right now."},{"title":"Profitability trend analysis for a single stock","prompt":"Show me Nvidia's gross margin, operating margin, and net margin on a quarterly basis from 2021 through 2023 — I want to see how profitability trended as the AI boom kicked in."},{"title":"Leverage and liquidity check before an investment","prompt":"Fetch the trailing twelve month debt-to-equity ratio, current ratio, and interest coverage figures for Tesla so I can assess how leveraged the balance sheet is before I decide whether to invest."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:36:01.553Z","isFirstParty":false,"canonicalSlug":"financial-metrics-by-ticker-cik-sec-derived-79fb2537"}