{"uid":"cap_qo2vEZt0EHSCE-s2BZu9l","slug":"stablefinance-financial-metrics-api-28267b5e","name":"StableFinance Financial Metrics API","description":"Valuation, profitability, liquidity, leverage, efficiency, growth, and per-share ratios over history.","url":"https://stablefinance.dev/api/financial-metrics","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["period"],"properties":{"cik":{"type":"string","minLength":1},"limit":{"type":"integer","maximum":50,"minimum":1},"period":{"enum":["annual","quarterly","ttm"],"type":"string"},"ticker":{"type":"string","minLength":1},"report_period":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["financial_metrics"],"properties":{"financial_metrics":{"type":"array","items":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"financial_metrics":[{"period":"ttm","ticker":"AAPL","currency":"USD","gross_margin":0.46,"fiscal_period":"FY2024","report_period":"2024-09-28","debt_to_equity":2.07,"revenue_growth":0.02,"return_on_equity":1.66,"price_to_earnings_ratio":38.58}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"period":"annual","ticker":"AAPL"}},"output":{"type":"json","example":{"financial_metrics":[]}}},"response":{"financial_metrics":[{"period":"annual","ticker":"AAPL","currency":"USD","peg_ratio":1.5093739070978842,"cash_ratio":0.21695214060169896,"filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm","market_cap":3791126029400,"net_margin":0.269,"quick_ratio":0.858770399261008,"gross_margin":0.469,"payout_ratio":0.136,"current_ratio":0.893,"ebitda_growth":0.07038464388942414,"fiscal_period":"2025-FY","report_period":"2025-09-27","asset_turnover":1.219,"debt_to_assets":0.2746262258483859,"debt_to_equity":3.872,"revenue_growth":0.0642551178283274,"earnings_growth":0.19495177946573355,"operating_cycle":69.98440007407093,"accession_number":"0000320193-25-000079","enterprise_value":3856555029400,"operating_margin":0.3189366615324358,"return_on_assets":0.328,"return_on_equity":1.64,"book_value_growth":0.2946971027216857,"interest_coverage":null,"earnings_per_share":7.547645311208129,"inventory_turnover":72.78086743616649,"price_to_book_ratio":51.417,"book_value_per_share":4.932,"free_cash_flow_yield":0.02605215422385504,"price_to_sales_ratio":9.11,"receivables_turnover":5.979324712643678,"free_cash_flow_growth":-0.09227347505215656,"days_sales_outstanding":0.1672429660636148,"operating_income_growth":0.0748592946511722,"price_to_earnings_ratio":33.846,"free_cash_flow_per_share":6.607,"working_capital_turnover":21.191618291068337,"earnings_per_share_growth":0.22424077557198974,"operating_cash_flow_ratio":0.6730744848488508,"return_on_invested_capital":0.513,"enterprise_value_to_ebitda_ratio":26.702,"enterprise_value_to_revenue_ratio":9.260476184457458},{"period":"annual","ticker":"AAPL","currency":"USD","peg_ratio":-59.00231490042666,"cash_ratio":0.16975259648963673,"filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm","market_cap":3463350367230,"net_margin":0.24,"quick_ratio":0.8260068483831466,"gross_margin":0.462,"payout_ratio":0.16,"current_ratio":0.867,"ebitda_growth":0.07724242545207777,"fiscal_period":"2024-FY","report_period":"2024-09-28","asset_turnover":1.127,"debt_to_assets":0.29215025480848267,"debt_to_equity":5.409,"revenue_growth":0.020219940775141214,"earnings_growth":-0.033599670086086914,"operating_cycle":63.58035130890676,"accession_number":"0000320193-24-000123","enterprise_value":3539089367230,"operating_margin":0.3157901466620635,"return_on_assets":0.27,"return_on_equity":1.379,"book_value_growth":-0.0836095645737457,"interest_coverage":null,"earnings_per_share":6.165164126053323,"inventory_turnover":53.66936590721932,"price_to_book_ratio":60.814,"book_value_per_share":3.712,"free_cash_flow_yield":0.031416688600011386,"price_to_sales_ratio":8.857,"receivables_turnover":6.146995944288993,"free_cash_flow_growth":0.092615279562982,"days_sales_outstanding":0.16268108992801156,"operating_income_growth":0.08571604417246959,"price_to_earnings_ratio":36.948,"free_cash_flow_per_share":7.091,"working_capital_turnover":20.187140239023257,"earnings_per_share_growth":-0.006262113873963643,"operating_cash_flow_ratio":0.6704045534944896,"return_on_invested_capital":0.444,"enterprise_value_to_ebitda_ratio":26.229,"enterprise_value_to_revenue_ratio":9.052991080670528},{"period":"annual","ticker":"AAPL","currency":"USD","peg_ratio":-275.90939934873023,"cash_ratio":0.20621713876730807,"filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm","market_cap":2676736860720,"net_margin":0.253,"quick_ratio":0.9444421504665951,"gross_margin":0.441,"payout_ratio":0.153,"current_ratio":0.988,"ebitda_growth":-0.03803174944511432,"fiscal_period":"2023-FY","report_period":"2023-09-30","asset_turnover":1.122,"debt_to_assets":0.3150690759338936,"debt_to_equity":4.673,"revenue_growth":-0.028004605303199367,"earnings_growth":-0.028135426790777834,"operating_cycle":74.26405047766644,"accession_number":"0000320193-23-000106","enterprise_value":2757608860720,"operating_margin":0.296740023742124,"return_on_assets":0.284,"return_on_equity":1.608,"book_value_growth":0.22643669087464477,"interest_coverage":null,"earnings_per_share":6.204014370517209,"inventory_turnover":60.540988785341966,"price_to_book_ratio":43.072,"book_value_per_share":3.947,"free_cash_flow_yield":0.03720350754732517,"price_to_sales_ratio":6.984,"receivables_turnover":6.287638311310154,"free_cash_flow_growth":-0.10641314393905404,"days_sales_outstanding":0.15904222706341234,"operating_income_growth":-0.04506183723331906,"price_to_earnings_ratio":27.597,"free_cash_flow_per_share":6.325,"working_capital_turnover":15.666666666666666,"earnings_per_share_growth":-0.0010002068773666407,"operating_cash_flow_ratio":0.7607495802020535,"return_on_invested_capital":0.387,"enterprise_value_to_ebitda_ratio":22.016,"enterprise_value_to_revenue_ratio":7.195324264502916}]}},"exampleRequest":{"limit":10,"period":"annual","ticker":"AAPL"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_FQZKAYSDRwIDpeJcC-ukv","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":"Retrieves key financial ratios and metrics for publicly traded companies by ticker or CIK, sourced from Financial Datasets AI, with pay-per-request billing via x402.","exampleAgentPrompt":"Pull the annual financial metrics for Apple (ticker AAPL) — I want to see things like gross margin, debt-to-equity, P/E ratio, and revenue growth for the last 10 periods.","exampleUseCases":null,"resultDescription":"Returns an array of financial metric objects for the requested company and period, each containing ratios and metrics such as gross margin, net margin, operating margin, debt-to-equity, return on equity, return on assets, revenue growth, earnings growth, P/E ratio, PEG ratio, market cap, enterprise value, EBITDA, current/quick/cash ratios, asset turnover, payout ratio, fiscal period label, report date, and SEC filing URL.","failureModes":["Missing required 'period' parameter returns a validation error","Invalid ticker symbol returns empty financial_metrics array or 404","CIK not found returns empty results","Report period date range yields no matching filings","Limit parameter out of range (must be 1-50) causes schema validation failure","Payment not made or x402 handshake fails results in 402 Payment Required response","Network timeout on Financial Datasets AI upstream"],"whenToPreferThis":"Use this endpoint when you need structured financial ratios and metrics for publicly traded US companies, especially when you want SEC-sourced data like margins, valuation ratios, leverage ratios, and growth rates across annual, quarterly, or TTM periods. Prefer this over raw SEC EDGAR queries when you need pre-computed ratios and metrics without parsing raw filings yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:35.583Z","isFirstParty":false}