{"uid":"cap_rW4aZFu2akhAIkO687idK","slug":"figurewell-api-point-in-time-sec-xbrl-financials-608eca36","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/metric?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":{"as_of":{"type":"string","description":"Only what was public by then (YYYY-MM-DD or ISO time)"},"limit":{"type":"integer","default":12,"description":"Periods, newest first (1-80)"},"metric":{"enum":["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"],"type":"string","default":"revenue","description":"One of: 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"},"period":{"enum":["quarter","annual","ytd","instant"],"type":"string","description":"quarter, annual, ytd or instant (default: the metric's own kind)"},"ticker":{"type":"string","description":"Stock ticker (or pass \"\" and use cik)"}}}}},"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_F11q-piVgNSNM0jo9DgYH","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 point-in-time SEC XBRL financial metrics for US public companies as first reported, with EDGAR acceptance timestamps and as_of filtering.","exampleAgentPrompt":"Pull Apple's quarterly revenue from SEC XBRL filings as first reported, going back 12 quarters, and make sure you only show data that was publicly available before January 1 2024.","exampleUseCases":[{"title":"Backtesting with point-in-time earnings data","prompt":"Get NVIDIA's diluted EPS as originally filed with the SEC for the last 20 quarters — I need the first-reported figures only, no restatements, with EDGAR acceptance timestamps so I can backtest without look-ahead bias."},{"title":"Screening for historically profitable companies","prompt":"Show me Microsoft's gross profit and operating income from SEC XBRL filings for the past 8 annual periods, as first reported — I want to see how consistent their margins have been over time."},{"title":"Checking financials available before an earnings date","prompt":"What revenue and net income figures for Tesla were publicly available in SEC EDGAR as of March 15 2023? Give me the quarterly data, first reported only, so I know exactly what the market could see at that moment."}],"resultDescription":"Returns a JSON array of per-filing financial data points for the requested metric and ticker, including the value as first reported, the reporting period, EDGAR acceptance time in UTC and New York timezone, and an after-close flag indicating whether the filing was released after market close. Results are ordered newest-first up to the specified limit, and can be filtered to only include data publicly available as of a given date.","failureModes":["Unknown or invalid ticker symbol returns an error or empty result","Metric enum value not recognized returns a validation error","as_of date in wrong format returns a parsing error","Requesting a period type incompatible with the metric (e.g. instant for revenue) may return empty or error","No XBRL data available for a given filer returns empty results","Rate limiting or payment failure (x402) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need point-in-time SEC XBRL fundamentals — especially when look-ahead bias matters, such as in backtesting, quantitative screening, or academic research. It is the right choice when you need first-reported values (not restated), EDGAR acceptance timestamps, or after-close flags for US public companies. Prefer it over general financial data APIs when SEC filing provenance and as_of filtering are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:04.978Z","isFirstParty":false,"canonicalSlug":"figurewell-api-point-in-time-sec-xbrl-financials-608eca36"}