{"uid":"cap_7yl2--c0D5P_5yjc-BoBu","slug":"x402stock-financial-statements-api-defead64","name":"x402stock Financial Statements API","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/financials/%7Bticker%7D","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":{"type":"json","example":{"data":{"count":1,"reports":[{"cik":"0000320193","end_date":"2026-03-28","timeframe":"ttm","start_date":"2025-03-29","statements":{"income_statement":{"revenues":408625000000,"net_income_loss":123563000000},"cash_flow_statement":{"net_cash_flow":17410000000}},"filing_date":null,"fiscal_year":null,"company_name":"APPLE INC","fiscal_period":"TTM","source_filing_url":null}]},"as_of":"2026-05-29T20:00:00.000Z","source":"x402stock","ticker":"AAPL"}},"example":null,"exampleRequest":null,"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_Jgur50uzw7bn3f8fetkgN","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 financial statements (income statement, cash flow, balance sheet) for a US stock ticker, with support for annual, quarterly, or TTM timeframes","exampleAgentPrompt":"Pull the trailing twelve month financial statements for AAPL — I want revenues, net income, and cash flow for the most recent report.","exampleUseCases":[{"title":"Compare quarterly revenue trends","prompt":"Pull the last eight quarters of financial statements for TSLA so I can compare how revenue and net income have trended over time."},{"title":"Analyze Microsoft annual cash flow","prompt":"Fetch the annual financial statements for MSFT going back five years — I need cash flow from operations and free cash flow figures for each year."},{"title":"Screen NVDA balance sheet strength","prompt":"Get the most recent balance sheet and income statement for NVDA so I can check their total debt, cash on hand, and trailing net income before my earnings call."}],"resultDescription":"Returns a structured JSON object containing financial statement data for the requested ticker, including income statement (revenues, net income), cash flow statement, and optionally balance sheet line items, along with fiscal period metadata (fiscal year, fiscal period, start/end dates, filing date), company name, CIK, and source filing URL. Covers up to 100 reports depending on the limit parameter.","failureModes":["Invalid or unknown ticker symbol returns empty or error response","Timeframe parameter not recognized if misspelled","Limit out of valid range (must be 1-100) causes validation error","Payment failure in x402 protocol results in 402 response blocking data","TTM data may have null filing_date and source_filing_url for computed periods","Ticker with no SEC filing history may return empty reports array"],"whenToPreferThis":"Use this endpoint when you need structured financial statement data (income, cash flow, balance sheet) for US public companies by ticker, especially for AI agent workflows that require no API key setup and support pay-per-call USDC billing via x402 on Base. Prefer over alternatives when you need TTM (trailing twelve month) aggregated financials or want to avoid subscription commitments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:22.477Z","isFirstParty":false}