{"uid":"cap_RHe8J3ERyFEFnjS9ai6db","slug":"sec-financial-facts-by-ticker-45c66410","name":"SEC Financial Facts by Ticker","description":"Use when you need sec filings company financials, earnings or fundamentals for a stock ticker for the last two fiscal years. Do not use for quarterly numbers, real-time prices, non-US companies or filings older than two years. Returns JSON with a US-listed company's annual revenue, net and operating income, diluted EPS, operating cash flow and year-end balance sheet from SEC filings for 0.02 USDC per call. Typical response time 300 ms (p95). Category: Data.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9.\\-]{0,9}$","description":"Stock ticker of a company that files with the SEC, e.g. AAPL"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ticker","cik","name","exchange","currency","fiscalYears","balanceSheets","source","dataUpdatedAt"],"properties":{"cik":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"name":{"type":"string"},"next":{"type":"object","required":["service","tool","method","url","useWhen","sample"],"properties":{"url":{"type":"string","description":"Paid route of the next call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"enum":["GET","POST"],"type":"string"},"sample":{"type":"string","description":"Free fixed sample of the whole family"},"service":{"type":"string","description":"Service id of the suggested next paid call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"source":{"type":"string"},"ticker":{"type":"string"},"currency":{"type":"string","const":"USD"},"exchange":{"type":["string","null"]},"fiscalYears":{"type":"array","items":{"type":"object","required":["calendarYear","start","end","revenue","netIncome","operatingIncome","epsDiluted","operatingCashFlow","accn"],"properties":{"end":{"type":"string"},"accn":{"type":["string","null"]},"start":{"type":["string","null"]},"revenue":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"epsDiluted":{"type":["number","null"]},"calendarYear":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"operatingIncome":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]}},"additionalProperties":false}},"balanceSheets":{"type":"array","items":{"type":"object","required":["calendarYear","asOf","assets","liabilities","equity","cash"],"properties":{"asOf":{"type":"string"},"cash":{"type":["number","null"]},"assets":{"type":["number","null"]},"equity":{"type":["number","null"]},"liabilities":{"type":["number","null"]},"calendarYear":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}},"dataUpdatedAt":{"type":["string","null"]}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"cik":320193,"name":"Apple Inc.","source":"SEC EDGAR XBRL frames (data.sec.gov)","ticker":"AAPL","currency":"USD","exchange":"Nasdaq","fiscalYears":[{"end":"2025-09-27","accn":"0000320193-25-000079","start":"2024-09-29","revenue":416161000000,"netIncome":112010000000,"epsDiluted":7.46,"calendarYear":2025,"operatingIncome":133050000000,"operatingCashFlow":111482000000},{"end":"2024-09-28","accn":"0000320193-25-000079","start":"2023-10-01","revenue":391035000000,"netIncome":93736000000,"epsDiluted":6.08,"calendarYear":2024,"operatingIncome":123216000000,"operatingCashFlow":118254000000}],"balanceSheets":[{"asOf":"2025-12-27","cash":45317000000,"assets":379297000000,"equity":88190000000,"liabilities":291107000000,"calendarYear":2025},{"asOf":"2024-12-28","cash":30299000000,"assets":344085000000,"equity":66758000000,"liabilities":277327000000,"calendarYear":2024}],"dataUpdatedAt":"2026-10-16T15:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_d797y-I5sIWrSKme_ii-D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a US-listed company's last two fiscal years of key annual financials (revenue, net income, EPS, cash flow, balance sheet) sourced directly from SEC filings for 0.02 USDC per call.","exampleAgentPrompt":"Pull the last two fiscal years of annual financials for NVDA from SEC filings — I need revenue, net income, diluted EPS, operating cash flow, and the year-end balance sheet.","exampleUseCases":[{"title":"Stock research fundamental snapshot","prompt":"Give me the last two years of annual revenue, net income, and diluted EPS for MSFT straight from their SEC filings so I can compare year-over-year growth."},{"title":"Pre-earnings operating cash flow check","prompt":"Before AAPL reports earnings, can you grab their last two fiscal years of operating cash flow and operating income from SEC filings for me?"},{"title":"Balance sheet review for investment thesis","prompt":"I'm evaluating Tesla as an investment — can you pull their annual balance sheet data and key income statement figures from their SEC filings for the last two fiscal years?"}],"resultDescription":"Returns a JSON object containing the company's CIK, name, exchange, currency (USD), and an array of fiscal year objects (for the last two years) each with start/end dates, revenue, net income, operating income, diluted EPS, operating cash flow, and accession number. Also includes a top-level balance sheet object and a 'next' field suggesting a follow-up call in the same family.","failureModes":["Invalid or non-existent ticker returns an error","Non-US company tickers not filing with SEC will fail","Quarterly data not available — only annual figures returned","Filings older than two fiscal years are not included","Rate limiting or payment failure for the 0.02 USDC micropayment","Companies with no SEC EDGAR history return empty or error response"],"whenToPreferThis":"Choose this endpoint when you need structured annual financial fundamentals (revenue, income, EPS, cash flow, balance sheet) for a US-listed company directly from SEC filings, covering the last two fiscal years, at a low per-call cost of $0.02 USDC. Prefer this over general financial data APIs when you need SEC-sourced data accuracy, or when working within an x402 micropayment-enabled agent pipeline. Do not use if you need quarterly figures, real-time prices, non-US companies, or data older than two fiscal years.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:12:10.386Z","isFirstParty":false,"canonicalSlug":"sec-financial-facts-by-ticker-45c66410"}