{"uid":"cap_vUteXfDC5p7W0DqbDULAh","slug":"agents-x402stock-xyz-x402stock-per-period-financial-statements-36fefa7f","name":"x402stock Per-Period Financial Statements","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://agents.x402stock.xyz/api/v1/financials/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":4,"maximum":100,"exclusiveMinimum":0},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."},"timeframe":{"enum":["annual","quarterly","ttm"],"type":"string"}}},"responseSchema":{"type":"object","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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zlg07cFG58pQuRnDWTbdp","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns SEC-sourced financial statements (income statement, balance sheet, cash flow, comprehensive income) as fact_key→value maps for a given US-listed ticker, filtered by timeframe and period count.","exampleAgentPrompt":"Pull the last 4 quarterly financial statements for TSLA — income statement, balance sheet, and cash flow — from SEC filings.","exampleUseCases":[{"title":"Earnings trend analysis for tech stock","prompt":"Get me the last 8 quarters of financial statements for NVDA so I can see how revenue and net income have trended."},{"title":"Annual fundamental review for value investing","prompt":"Pull the last 5 annual financial statements for BRK.B — income statement, balance sheet, and cash flow — so I can evaluate its long-term fundamentals."},{"title":"TTM snapshot for quick company valuation","prompt":"I need the trailing twelve month financial statements for AMZN to get a current picture of its profitability and cash position."}],"resultDescription":"An array of financial report objects, each containing company name, CIK, timeframe, fiscal period/year, start and end dates, filing date, SEC source filing URL, and a 'statements' map where each key is a statement type (e.g. income_statement, balance_sheet) and each value is a flat fact_key→number map of all reported XBRL financial metrics for that period.","failureModes":["Invalid or unknown ticker symbol returns empty data or error","Ticker not found in SEC EDGAR returns null CIK or empty reports array","Requesting TTM for a company with insufficient filing history may return partial data","limit exceeding 100 is rejected by schema validation","Network or payment failure via x402 protocol returns no data","Delisted or OTC tickers may not have SEC XBRL coverage"],"whenToPreferThis":"Choose this endpoint when you need structured, multi-statement financial data (income statement, balance sheet, cash flow, comprehensive income) for a specific US-listed company across multiple fiscal periods from SEC filings. It is ideal for fundamental analysis, valuation models, earnings trend tracking, or any agent workflow that needs official GAAP figures flattened into machine-readable key-value maps. Prefer this over the single-concept XBRL time-series endpoint when you need a full cross-section of all financial statement line items for one or more reporting periods at once.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T12:51:33.115Z","isFirstParty":false}