{"uid":"cap_WWtTPQiCp0nbohQ5WiBQ7","slug":"x402stock-company-facts-sec-edgar-d5493cfc","name":"x402stock Company Facts (SEC EDGAR)","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/company-facts/%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":50,"maximum":500,"exclusiveMinimum":0},"search":{"type":"string"},"taxonomy":{"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":["entity_name","cik","taxonomy","search","total_facts","count","facts"],"properties":{"cik":{"type":"string"},"count":{"type":"number"},"facts":{"type":"array","items":{"type":"object","required":["tag","taxonomy","label","unit","latest_value","end","fiscal_year","fiscal_period","form","filed"],"properties":{"end":{"type":"string"},"tag":{"type":"string"},"form":{"type":"string"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"filed":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxonomy":{"type":"string"},"fiscal_year":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest_value":{"type":"number"},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"search":{"anyOf":[{"type":"string"},{"type":"null"}]},"taxonomy":{"type":"string"},"entity_name":{"type":"string"},"total_facts":{"type":"number"}},"additionalProperties":false},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","const":"sec_edgar"},"ticker":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":{"cik":"0000320193","count":1,"facts":[{"end":"2026-03-28","tag":"RevenueFromContractWithCustomerExcludingAssessedTax","form":"10-Q","unit":"USD","filed":"2026-05-01","label":"Revenue from Contract with Customer, Excluding Assessed Tax","taxonomy":"us-gaap","fiscal_year":2026,"latest_value":111184000000,"fiscal_period":"Q2"}],"search":"revenue","taxonomy":"us-gaap","entity_name":"Apple Inc.","total_facts":12},"as_of":"2026-05-01T00:00:00.000Z","source":"sec_edgar","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_dle7j1_HLCaGkqWblp5tt","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 structured SEC EDGAR financial fact data for a public US company by ticker symbol, searchable by taxonomy and keyword.","exampleAgentPrompt":"Pull the latest SEC EDGAR facts for Apple (AAPL) related to revenue — search for 'revenue' within the us-gaap taxonomy and return up to 10 results.","exampleUseCases":[{"title":"Verify Tesla net income from filings","prompt":"Look up the latest SEC EDGAR financial facts for Tesla (TSLA) related to net income — search for 'NetIncomeLoss' in the us-gaap taxonomy and show me the most recent reported figures including the filing form type and fiscal period."},{"title":"Pull Microsoft asset data from EDGAR","prompt":"Grab the SEC EDGAR XBRL facts for Microsoft (MSFT) related to total assets — search for 'Assets' within the us-gaap taxonomy and return the last 5 results so I can see what they've officially reported on their balance sheet."},{"title":"Find Amazon revenue across fiscal years","prompt":"Pull structured SEC filing data for Amazon (AMZN) and search for 'Revenues' in the us-gaap taxonomy — I want to see the reported revenue figures across recent fiscal years, including the period end dates and which forms they were filed on."}],"resultDescription":"A JSON object containing the company's CIK, entity name, ticker, data source (sec_edgar), as-of timestamp, and an array of matching financial facts — each with XBRL tag, taxonomy, human-readable label, unit, latest reported value, filing form type, fiscal year, fiscal period, period end date, and filed date.","failureModes":["Invalid or unknown ticker returns an empty result or 404","No facts matching the search/taxonomy filter returns count 0 and empty facts array","Ticker for a non-SEC-registered entity (e.g. foreign company not cross-listed) may return no data","Payment failure via x402/USDC results in 402 response before data is returned","limit parameter out of range (<=0 or >500) returns a validation error"],"whenToPreferThis":"Use this endpoint when you need structured, auditable financial data directly from SEC EDGAR XBRL filings — ideal for retrieving specific accounting line items (revenue, net income, assets) by GAAP/IFRS tag, verifying reported figures from official filings, or building financial analysis on top of regulatory disclosures. Prefer this over market data endpoints when you need filing-sourced figures rather than real-time prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:56.402Z","isFirstParty":false}