{"uid":"cap_pL3rpzaLljktmG8q_BvFz","slug":"figurewell-api-point-in-time-sec-xbrl-financials-acd246cd","name":"Figurewell API: Point-in-Time SEC XBRL Financials","description":"Point-in-time SEC XBRL fundamentals API: per-filing key metrics (revenue, gross profit, operating income, net income, EPS, shares, assets, liabilities, equity, cash, long-term debt, operating cash flow, capex, dividends, free cash flow, margins) for every US SEC filer, as first reported, with EDGAR acceptance time (UTC and New York), after-close flag, as_of filtering, multi-ticker snapshots and first-reported vs restated history per metric. REST + MCP server. Information only, not investment advice.","url":"https://figurewell-api.cybermaxtools.com/x402/api/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 CIK number, for companies without a listed ticker"},"form":{"enum":["all","annual","quarterly"],"type":"string","default":"all","description":"all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)"},"as_of":{"type":"string","description":"Point in time: only filings EDGAR had accepted by then. YYYY-MM-DD (end of day, New York) or ISO time with offset. Empty = now"},"limit":{"type":"integer","default":8,"description":"Filings, newest accepted first (1-40)"},"fields":{"type":"string","description":"Only these metrics (comma separated): revenue, cost_of_revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, diluted_shares, total_assets, current_assets, total_liabilities, current_liabilities, stockholders_equity, cash, long_term_debt, operating_cash_flow_ytd, capex_ytd, dividends_paid_ytd, free_cash_flow_ytd, gross_margin, net_margin"},"offset":{"type":"integer","default":0,"description":"Skip filings (paging)"},"ticker":{"type":"string","description":"Stock ticker (e.g. AAPL). Or pass \"\" and use cik"},"amendments":{"type":"boolean","default":false,"description":"Include 10-K/A and 10-Q/A amendments (default false)"}}}}},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"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_BRMNgu5xQ3gGmCDJyPwsV","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":"Returns per-filing SEC XBRL financial metrics (revenue, income, EPS, assets, cash flow, margins, etc.) for US public companies as first reported, with EDGAR acceptance timestamps and point-in-time filtering.","exampleAgentPrompt":"Pull the last 8 quarterly SEC filings for MSFT as of 2024-06-30, showing only revenue, net income, EPS diluted, and free cash flow — give me the first-reported figures with EDGAR acceptance times.","exampleUseCases":[{"title":"Backtest with point-in-time financials","prompt":"I'm building a quantitative strategy and need to avoid look-ahead bias — can you get me Apple's (AAPL) annual revenue, operating income, and free cash flow as they were first reported, with EDGAR acceptance timestamps, going back 10 filings as of December 31 2022?"},{"title":"Earnings surprise research","prompt":"For TSLA, pull the last 12 quarterly 10-Q filings showing EPS basic, EPS diluted, and net income as first reported, including the EDGAR acceptance time and whether each was filed after market close — I want to study earnings surprise patterns."},{"title":"Multi-metric balance sheet snapshot","prompt":"Give me the most recent 4 annual filings for NVDA showing total assets, total liabilities, stockholders equity, cash, and long-term debt as of today, excluding any amendments."}],"resultDescription":"A JSON array of per-filing records for the requested ticker or CIK, each containing the requested financial metrics (e.g. revenue, net income, EPS, margins, cash flow), the filing form type, period of report, EDGAR acceptance timestamp in UTC and New York time, an after-close boolean flag, and whether the figures are first-reported or restated. Results are ordered newest-accepted-first and filtered to only filings EDGAR had accepted by the as_of date.","failureModes":["Unknown ticker or CIK returns an error or empty result set","as_of date in the future or invalid format returns a 400 error","Requesting more than 40 filings (limit > 40) returns a validation error","Invalid field names in the fields parameter return an error","No XBRL data available for older or non-standard filers returns empty metrics","Rate limiting or payment failure (x402) returns a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need US public company financial fundamentals exactly as they were reported to the SEC at a specific point in time — especially for backtesting (to avoid look-ahead bias), earnings analysis, or building financial models that require first-reported vs restated distinctions. It is superior to generic financial data APIs when EDGAR acceptance timestamps, after-close flags, and point-in-time as_of filtering are required. Best for quantitative researchers, financial analysts, and AI agents that need auditable, SEC-sourced XBRL data rather than aggregated or normalized third-party financials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:17.158Z","isFirstParty":false,"canonicalSlug":"figurewell-api-point-in-time-sec-xbrl-financials-608eca36"}