{"uid":"cap_HAMR2UWg9jFIdjdtBtlrp","slug":"x402-agent-hub-sec-xbrl-company-financials-edd49ca1","name":"x402 Agent Hub – SEC XBRL Company Financials","description":"Reported fundamentals for US-GAAP filers from SEC XBRL data: revenue, operating income, net income, diluted EPS, operating cash flow, capex, free cash flow, total assets/liabilities, equity, cash, margins and YoY revenue growth for the last 1-12 annual or quarterly periods. Q4 and quarterly cash flows are derived from year-to-date filings and flagged. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","url":"https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/financials?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"],"type":"string"},"queryParams":{"type":"object","properties":{"cik":{"type":"string","description":"SEC Central Index Key, e.g. 320193 (alternative to ticker)."},"limit":{"type":"string","description":"Number of periods, 1-12 (default 4)."},"period":{"type":"string","description":"annual (default) or quarterly."},"ticker":{"type":"string","description":"US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"period":"annual","company":{"cik":320193,"name":"Apple Inc.","ticker":"AAPL"},"periods":[{"revenue":416161000000,"netIncome":112010000000,"periodEnd":"2025-09-27","epsDiluted":7.46,"fiscalYear":2025,"freeCashFlow":98767000000,"netMarginPercent":26.92,"revenueGrowthYoYPercent":6.43}],"currency":"USD"}},"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_3Ia6jh1IdPsWX7YjIpZnG","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 US-GAAP financial fundamentals (revenue, income, EPS, cash flow, margins, growth) from SEC XBRL data for up to 12 annual or quarterly periods for any US-listed company.","exampleAgentPrompt":"Pull Apple's last 8 annual periods of SEC GAAP financials — I want revenue, net income, free cash flow, diluted EPS, and net margin for AAPL.","exampleUseCases":[{"title":"Annual revenue trend for earnings research","prompt":"Get me Apple's annual revenue, net income, and free cash flow for the last 8 years from SEC XBRL data — ticker is AAPL."},{"title":"Quarterly EPS history for valuation model","prompt":"Fetch the last 12 quarters of diluted EPS and net margin for Microsoft (ticker MSFT) from SEC filings so I can build a valuation model."},{"title":"Cash flow deep-dive for an obscure filer","prompt":"I need operating cash flow, capex, and free cash flow for the last 4 annual periods for the company with SEC CIK 1018724 — use annual period type."}],"resultDescription":"A JSON object containing the company's name, ticker, and CIK, the period type (annual or quarterly), the currency (USD), and an array of period objects each with: period end date, fiscal year, revenue, net income, operating income, diluted EPS, operating cash flow, capex, free cash flow, total assets, total liabilities, equity, cash, net margin percent, and revenue YoY growth percent. Derived Q4/quarterly cash flow values are flagged. Charges $0.005 USDC only on successful reads; invalid inputs or upstream errors cancel settlement.","failureModes":["Invalid or unrecognized ticker symbol returns not-found error with no charge","CIK not found in SEC EDGAR returns not-found error with no charge","Requesting more than 12 periods returns input validation error","Company has no XBRL filings (e.g. non-US or non-GAAP filers) returns not-found","Upstream SEC EDGAR outage returns upstream error with no charge","Quarterly cash flow figures derived from YTD filings may be flagged as estimated"],"whenToPreferThis":"Choose this endpoint when you need standardized US-GAAP reported financials (revenue, income, EPS, cash flow, margins) sourced directly from SEC XBRL submissions for any US-listed public company. It is ideal for fundamental analysis, valuation models, earnings research, and financial dashboards where authoritative reported figures — not estimated or scraped data — are required. It covers both annual and quarterly periods (up to 12) and charges only on successful reads, making it cost-safe for exploratory queries. Prefer alternatives if you need non-US companies, real-time earnings estimates, or analyst consensus data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T12:34:40.359Z","isFirstParty":false,"canonicalSlug":"x402-agent-hub-sec-xbrl-company-financials-edd49ca1"}