{"uid":"cap_rVrgAjKlNI8v2qhrxxE54","slug":"edgar-company-financial-data-lookup-762af021","name":"EDGAR Company Financial Data Lookup","description":"Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, basewatch, chainread, check-sanctions, chgwatch, company-facts, composite, edgar, feednews, pageaudit, solcheck, token-dd, txpreflight, walletcheck, webmd, webread, websearch, x402index. Each operation describes its service.","url":"https://api.firstmention.uk/s/edgar/company?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Ticker, company name or CIK, e.g. AAPL, nvidia, 320193"},"tag":{"type":"string","description":"XBRL tag or alias: revenue, net_income, assets, cash, eps, or any us-gaap tag"},"limit":{"type":"integer","description":"Max results (1-100)"},"period":{"enum":["all","annual","quarterly"],"type":"string","description":"all, annual or quarterly"}}},"responseSchema":{"type":"json","example":{"cik":320193,"tag":"Revenues","name":"Apple Inc.","unit":"USD","count":6,"latest":{"fy":2025,"end":"2025-09-27","form":"10-K","value":416161000000},"period":"annual","values":[{"fp":"FY","fy":2025,"end":"2025-09-27","form":"10-K","value":416161000000}],"matched":{"cik":320193,"name":"Apple Inc.","ticker":"AAPL"},"taxonomy":"us-gaap"}},"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_bh-OpG5UnUU_l4pi55bpb","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 XBRL financial metrics (revenue, net income, assets, etc.) for any public company from the SEC EDGAR database by ticker, name, or CIK","exampleAgentPrompt":"Pull Apple's annual revenue from SEC EDGAR for the last 6 years — use ticker AAPL, the Revenues XBRL tag, and limit results to 6 annual periods.","exampleUseCases":[{"title":"Revenue trend analysis for earnings research","prompt":"Get me Apple's annual revenue figures from SEC EDGAR going back as far as available — use AAPL as the ticker and the revenue tag, annual periods only, up to 10 results."},{"title":"Quarterly EPS history for a stock screener","prompt":"I need NVIDIA's quarterly EPS data from EDGAR — search by the ticker NVDA, use the EPS tag, quarterly period, and give me the last 20 quarters."},{"title":"Balance sheet assets lookup by CIK","prompt":"Look up Microsoft's total assets from SEC filings using CIK 789019, the assets XBRL tag, and return both annual and quarterly results — up to 50 periods."}],"resultDescription":"Returns a JSON object containing the matched company (CIK, name, ticker), the resolved XBRL tag and taxonomy, the unit of measure (e.g. USD), a count of matching periods, the latest filing value with fiscal year and form type (10-K/10-Q), and a full time-series array of period values each with fiscal year, end date, form, and reported value.","failureModes":["Unknown ticker or company name returns no match or empty result","Invalid or non-existent XBRL tag returns an error or empty values array","Company has no EDGAR filings (e.g. foreign private issuer) — no data returned","Limit parameter out of range (outside 1-100) causes validation error","Period filter mismatch — requesting annual for a metric only filed quarterly returns sparse results","Payment failure via x402/USDC results in 402 response before data is returned"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable financial fundamentals directly from SEC EDGAR XBRL data — especially for US public companies where official filing accuracy matters. Prefer this over web scraping or third-party financial data providers when auditability to the source filing is important, or when you need to search by CIK in addition to ticker. It is particularly well-suited for time-series financial analysis across fiscal years or quarters with a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:39:36.208Z","isFirstParty":false,"canonicalSlug":"edgar-company-financial-data-lookup-762af021"}