{"uid":"cap_OyR0GFXm-leLVmQlovNLE","slug":"x402stock-xyz-d9b9d420","name":"x402stock.xyz Financial Statements API","description":"Per-period financial statements (income statement, balance sheet, cash flow, comprehensive income) sourced from SEC filings, flattened to fact_key → value maps. Pass `?timeframe=annual|quarterly|ttm` and `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.","url":"https://x402stock.xyz/api/v1/financials/AAPL","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":["limit"],"properties":{"limit":{"type":"integer","default":4,"maximum":100,"exclusiveMinimum":0},"timeframe":{"enum":["annual","quarterly","ttm"],"type":"string"}},"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":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["count","reports"],"properties":{"count":{"type":"number"},"reports":{"type":"array","items":{"type":"object","required":["company_name","cik","timeframe","fiscal_period","fiscal_year","start_date","end_date","filing_date","source_filing_url","statements"],"properties":{"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"statements":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}]},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_filing_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":4,"timeframe":"annual"}}},"response":{"_truncated":true,"_originalSize":11034}},"exampleRequest":{"limit":4,"timeframe":"annual"},"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_P5bqNQMSNwj_czMz0s4Dn","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 multi-period financial statement data (income, balance sheet, cash flow) for a given stock ticker, with optional timeframe filtering.","exampleAgentPrompt":"Can you pull the last 4 annual financial statements for AAPL — I want income, balance sheet, and cash flow data?","exampleUseCases":null,"resultDescription":"Returns a structured JSON object containing the ticker symbol, as-of date, source, and an array of financial reports. Each report includes company name, CIK, timeframe, fiscal period, fiscal year, start/end dates, filing date, source filing URL, and a statements object with financial line items (e.g. revenues, net income, assets, liabilities, cash flows) keyed by statement type and metric name.","failureModes":["Invalid or unknown ticker symbol returns empty data or 404","Unsupported timeframe enum value returns validation error","Limit parameter of 0 or negative returns error (exclusiveMinimum: 0)","Ticker with no filings in the requested timeframe returns empty reports array","Network or payment (x402) failure results in no response"],"whenToPreferThis":"Use this endpoint when you need structured, multi-period financial statement data (income statement, balance sheet, cash flow) for a specific US-listed public company ticker. Prefer this over general search endpoints when you already know the ticker symbol and need quantitative financial metrics across fiscal periods. Ideal for financial analysis, screening, or building financial models.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:47.824Z","isFirstParty":false}