{"uid":"cap_B7aA7u5YKQafZLPiGhsaN","slug":"sec-xbrl-financial-facts-lookup-22132dc1","name":"SEC XBRL Financial Facts Lookup","description":"Pay-per-call utilities for AI agents over x402, USDC on Base.","url":"https://agents.crowdspark.me/v1/finance/sec-facts?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","required":[],"properties":{"cik":{"type":"string","description":"Optional SEC CIK, e.g. 320193"},"limit":{"type":"string","description":"1 to 40, default 10"},"period":{"enum":["annual","quarterly","all"],"type":"string"},"ticker":{"type":"string","description":"Stock ticker, e.g. AAPL. Give ticker or cik"},"concept":{"type":"string","description":"revenue (default), net_income, eps, assets, liabilities, cash, operating_income, equity, shares, or a us-gaap tag"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"period":"annual","source":"SEC EDGAR XBRL companyconcept (data.sec.gov, public)","values":[{"end":"2025-09-27","form":"10-K","filed":"2025-10-31","start":"2024-09-29","value":112010000000,"fiscal_year":2025,"fiscal_period":"FY","accession_number":"0000320193-25-000079"}],"company":{"cik":"320193","name":"Apple Inc."},"concept":{"tag":"NetIncomeLoss","unit":"USD","label":"Net Income (Loss) Attributable to Parent"},"returned":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aXq0otcFAM-_6f9-xesCE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical financial figures from SEC XBRL filings for a US-listed company by ticker or CIK, including revenue, net income, EPS, assets, liabilities, and any us-gaap tag, for annual or quarterly periods.","exampleAgentPrompt":"Pull Apple's annual revenue figures from SEC XBRL filings for the last 5 years — I want the period dates, fiscal year, and form type for each entry.","exampleUseCases":[{"title":"Multi-year earnings trend analysis","prompt":"Get me Tesla's quarterly net income from SEC EDGAR XBRL filings going back 8 quarters, including the filing date and accession number for each period."},{"title":"EPS history for valuation model","prompt":"Fetch Microsoft's annual EPS figures from SEC XBRL filings for the last 10 years so I can build a historical earnings-per-share trend."},{"title":"Balance sheet snapshot from SEC data","prompt":"Look up Amazon's total assets and total liabilities from their most recent annual SEC XBRL filing using their ticker AMZN."}],"resultDescription":"Returns a JSON object with company info (name, CIK), the requested financial concept (us-gaap tag, unit, label), and an array of period values each containing the numeric value, start/end dates, fiscal year and period, SEC form type (e.g. 10-K, 10-Q), filing date, and accession number. Also indicates the period filter applied (annual/quarterly/all) and the data source.","failureModes":["Unknown ticker or CIK returns an error or empty values array","Invalid concept name returns an error or falls back to default","Limit out of range (outside 1–40) may be rejected or clamped","Company has no XBRL data for the requested concept (returns empty values)","SEC EDGAR source unavailable causes upstream failure"],"whenToPreferThis":"Choose this endpoint when you need structured historical financial data directly from official SEC XBRL filings for any US-listed public company — especially when you need period metadata like accession numbers, form types, and filing dates alongside the financial figures. It is ideal for building trend analyses, populating financial models, or cross-referencing with specific SEC filings. Prefer it over general financial data APIs when regulatory sourcing and data provenance (SEC EDGAR) matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:17.974Z","isFirstParty":false,"canonicalSlug":"sec-xbrl-financial-facts-lookup-22132dc1"}