{"uid":"cap_leWML8AVBNdkTn2ah_zoQ","slug":"sec-edgar-financial-ratios-api-69ccc90a","name":"SEC EDGAR Financial Ratios API","description":"Key financial ratios computed from SEC EDGAR XBRL: margins, liquidity, leverage and growth. Give a ticker or CIK and get ratios over recent periods, each computed number citing the source facts it was derived from, plus restatement flags and simple anomaly flags.","url":"https://payai.agentstools.dev/edgar/ratios?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":[],"properties":{"cik":{"type":"string","description":"SEC EDGAR CIK, any zero-padding accepted"},"freq":{"enum":["annual","quarterly"],"type":"string","description":"Reporting frequency, default annual"},"ticker":{"type":"string","description":"Stock ticker symbol, e.g. AAPL"},"periods":{"type":"integer","maximum":12,"minimum":1,"description":"Number of recent periods to return, default 8"}}}},"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":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":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_oSZ2zgGx2-twS4rZ4vVzh","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":"Computes key financial ratios (margins, liquidity, leverage, growth) from SEC EDGAR XBRL data for a given ticker or CIK over recent reporting periods, with source citations and anomaly flags.","exampleAgentPrompt":"Pull the last 8 annual periods of financial ratios for Apple (ticker AAPL) from SEC EDGAR — I want margins, liquidity, leverage, and growth, with source citations and any restatement or anomaly flags.","exampleUseCases":[{"title":"Competitive margin analysis across tech peers","prompt":"Can you grab the last 4 quarters of profit margins for Microsoft, Google, and Meta from their SEC filings? I need to see how they compare and want to flag any unusual swings or restatements."},{"title":"Debt sustainability check for acquisition targets","prompt":"Pull the leverage and liquidity ratios for these three companies I'm looking at acquiring—show me their current ratio, debt-to-equity, and whether there are any anomalies in their recent XBRL data that might be red flags."},{"title":"Growth rate validation for earnings calls","prompt":"I'm preparing for our analyst meeting and need the revenue growth rates for the last 6 quarters for Tesla pulled straight from SEC filings with source citations—help me spot any restatements or odd jumps in the numbers."}],"resultDescription":"A set of key financial ratios (profit margins, liquidity ratios, leverage ratios, growth rates) computed from SEC EDGAR XBRL facts over the requested number of recent periods, each figure annotated with the source XBRL facts used in the calculation, plus boolean flags for any detected restatements or anomalies.","failureModes":["Unknown ticker or CIK returns an error or empty result","Company has insufficient XBRL data for the requested number of periods","Rate limiting or payment failure (x402) if USDC balance is insufficient","EDGAR data may be delayed relative to the most recent filing","Some ratios may be unavailable if the company did not report required line items"],"whenToPreferThis":"Use this endpoint when you need auditable, source-cited financial ratios directly derived from official SEC EDGAR XBRL filings for US public companies, especially when transparency into the underlying accounting facts or restatement history matters. Prefer over screener APIs when you need ratio provenance or anomaly detection rather than just raw numbers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:49:43.118Z","isFirstParty":false,"canonicalSlug":"sec-edgar-financial-ratios-api-69ccc90a"}