{"uid":"cap_MMdMOHXcD9vsrK2UNsZCS","slug":"scrapemole-companies-sec-edgar-financials-b60352ab","name":"ScrapeMole Companies: SEC EDGAR Financials","description":"Pay-per-call US company data for agents from SEC EDGAR (public domain): company/ticker search, company profiles (industry, incorporation, filer category, addresses, latest filings), XBRL financials (revenue, net income, EPS, cash flow, balance sheet; 5 years + 4 quarters) and filing lists with document links. USDC via x402, no accounts; failed calls are never charged.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://companies.scrapemole.workers.dev/terms","url":"https://companies.scrapemole.workers.dev/v1/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","required":[],"properties":{"cik":{"type":"string","description":"SEC CIK. Give ticker or cik."},"ticker":{"type":"string","examples":["AAPL"],"description":"Stock ticker, e.g. AAPL. Give ticker or cik."},"metrics":{"type":"string","description":"Comma-separated subset, e.g. \"revenue,netIncome\". Default all."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"cik":320193,"name":"Apple Inc.","ticker":"AAPL","metrics":{"revenue":{"unit":"USD","annual":[{"fp":"FY","fy":2025,"end":"2025-09-27","accn":"0000320193-25-000079","form":"10-K","filed":"2025-10-31","start":"2024-09-29","value":416161000000}],"concept":"us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax","quarterly":[{"fp":"Q3","fy":2026,"end":"2026-06-27","accn":"0000320193-26-000020","form":"10-Q","filed":"2026-07-31","start":"2026-03-29","value":109417000000}]}},"currency":"USD","sharesOutstanding":{"asOf":"2026-07-17","form":"10-Q","value":14594180000}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pyelJjEkZIJj1Tz-7kbhc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves XBRL financial metrics (revenue, net income, EPS, cash flow, balance sheet) for a US public company from SEC EDGAR, covering 5 annual years and 4 quarters.","exampleAgentPrompt":"Pull Apple's revenue, net income, and EPS from SEC EDGAR — I want both the last 5 annual years and the most recent 4 quarters. Use ticker AAPL.","exampleUseCases":[{"title":"Annual revenue trend for earnings research","prompt":"Get me Apple's annual revenue for the past 5 years from SEC EDGAR so I can chart the growth trend — use ticker AAPL."},{"title":"Quarterly net income for valuation model","prompt":"I need Tesla's quarterly net income for the last 4 quarters from their SEC filings — ticker is TSLA."},{"title":"Balance sheet snapshot for credit analysis","prompt":"Fetch the latest balance sheet data for Microsoft from SEC EDGAR, including total assets and total liabilities — use ticker MSFT."}],"resultDescription":"Returns a JSON object containing the company's CIK, name, ticker, and a metrics map. Each requested metric includes its XBRL concept name, unit (e.g. USD), an annual array of up to 5 fiscal year data points, and a quarterly array of up to 4 recent quarters. Each data point includes fiscal period, fiscal year, start/end dates, filing accession number, form type, filed date, and the reported value. Also includes currency and shares outstanding with an as-of date.","failureModes":["Missing ticker and CIK — both are optional but at least one must be provided; returns 400 if neither is given","Unknown ticker or CIK — company not found in SEC EDGAR returns an error","Metric name not recognized — invalid metric in the comma-separated list may return empty or error","No XBRL data available — some smaller filers may not have machine-readable XBRL financials","Payment failure — x402 payment not verified results in no charge and no response","Rate limiting or network issues at the SEC EDGAR data source"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable financial statement data (income statement, balance sheet, cash flow) for US public companies sourced directly from SEC EDGAR XBRL filings. It is ideal for agents that need no API account setup, pay only per successful call in USDC, and require historically consistent multi-year or multi-quarter data. Prefer it over general financial data APIs when regulatory-grade, public-domain sourcing from SEC filings is important, or when you need specific XBRL concept-level data with filing provenance (accession number, form type, filed date).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:38:13.164Z","isFirstParty":false,"canonicalSlug":"scrapemole-companies-sec-edgar-financials-b60352ab"}