{"uid":"cap_rSlnTR7SDRoYsdG9p3PYY","slug":"us-company-fundamentals-sec-d1eafa58","name":"US Company Fundamentals (SEC)","description":"Reported financials for a US-listed company from its SEC 10-K/10-Q filings: revenue, gross profit, operating and net income, diluted EPS, cash flow, capex, free cash flow, assets, liabilities, equity, cash, debt and margins, annual or quarterly. Use when analysing, comparing or valuing a US stock by ticker and you need filed numbers, not estimates.","url":"https://bess-x402.onrender.com/v1/us-stocks/fundamentals?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":["ticker"],"properties":{"limit":{"type":"integer","description":"Number of most recent periods, 1-20, default 5"},"period":{"enum":["annual","quarterly"],"type":"string","description":"Default annual"},"ticker":{"type":"string","description":"US ticker such as AAPL or BRK-B, or a numeric SEC CIK"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yPzVjF8vd65NX_nCaUcgy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns reported financial fundamentals (revenue, earnings, cash flow, balance sheet, margins) for a US-listed company from SEC 10-K/10-Q filings, by ticker or CIK, for annual or quarterly periods.","exampleAgentPrompt":"Pull the last 8 quarters of SEC-filed fundamentals for Apple (AAPL) — I need revenue, net income, diluted EPS, free cash flow, and total debt from its 10-Q filings.","exampleUseCases":[{"title":"Stock valuation before earnings call","prompt":"Get me the last 5 annual periods of SEC-filed financials for Microsoft (MSFT) — revenue, operating income, free cash flow and total equity — so I can build a DCF model."},{"title":"Comparing margins across competitors","prompt":"Pull the most recent 4 quarters of gross margin, operating margin and net income for both Nvidia (NVDA) and AMD — I want to compare their profitability from actual SEC filings, not analyst estimates."},{"title":"Checking a company's balance sheet health","prompt":"Show me the latest annual balance sheet data for Coca-Cola (KO) from its 10-K: total assets, total liabilities, cash on hand and total debt."}],"resultDescription":"Returns a structured list of financial periods (annual or quarterly), each containing income statement items (revenue, gross profit, operating income, net income, diluted EPS), cash flow items (operating cash flow, capex, free cash flow), balance sheet items (total assets, total liabilities, equity, cash, debt), and computed margin ratios — all as reported in SEC 10-K or 10-Q filings.","failureModes":["Unknown or invalid ticker returns an error or empty result","Non-US or OTC-only tickers not covered by SEC EDGAR will fail","Limit parameter out of range (must be 1-20) may return validation error","Very small or newly listed companies may have sparse filing history","Network or upstream EDGAR unavailability may cause timeout"],"whenToPreferThis":"Use this endpoint when you need actual SEC-filed financial figures (not analyst estimates or consensus forecasts) for a US-listed public company, for fundamental analysis, stock valuation, margin comparison, or historical financial trend review. Prefer this over earnings-estimate APIs when accuracy of reported numbers matters, or when building models based on GAAP-reported data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:25:07.999Z","isFirstParty":false,"canonicalSlug":"us-company-fundamentals-sec-d1eafa58"}