{ "openapi": "3.1.0", "info": { "title": "Figurewell API API", "version": "1.0.0", "summary": "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.", "description": "Paid API keys from $19/month (Quant: 10,000 calls a month); free tier 100 calls a day per IP with no key. Buy: https://figurewell-api.cybermaxtools.com/buy/quant?s=lead ยท all plans: https://figurewell-api.cybermaxtools.com/docs#pricing\n\nPricing: free tier 100 calls/day per IP, no key. Paid API keys: Quant $19/month = 10,000 calls/month; Research $49/month = 50,000 calls/month; Fund $99/month = 150,000 calls/month; Pay as you go $5 = 1,500 calls (one-time pack); Quant yearly $190/year = 10,000 calls/month; Research yearly $490/year = 50,000 calls/month; Fund yearly $990/year = 150,000 calls/month. Get a key: https://figurewell-api.cybermaxtools.com/docs#pricing\n\nRevenue, earnings, EPS, cash, debt and cash flow from every 10-K, 10-Q, 20-F and 40-F in SEC EDGAR's XBRL data since 2009, as each filing first reported them, stamped with the minute EDGAR accepted the filing. Ask \"what did we know on 2024-06-30?\" and get no look-ahead and no restated numbers. For backtests, quant research, screeners and AI agents. Free tier, no key; plans from $5 (one-time pack) or $19/month.\n\nFree tier: Up to 40 filings per call (page with offset), 10 tickers per snapshot; 10 calls a minute per IP on the free tier. Free tier: 100 calls a day per IP, no key. Paid keys from $5 (one-time pack) or $19/month (see Get an API key). Coverage: XBRL financial data the SEC publishes (most filers from 2009-2011 on). Each company is re-read from EDGAR at most every 12 hours, so a filing accepted minutes ago can take up to 12 hours to appear. Values are the 18 standard metrics mapped from us-gaap/IFRS tags (tags_used says which); companies that use custom tags can have gaps. Quarterly Q4 values are usually only reported inside the annual report. Information only, not investment advice. No key needed. Remote MCP server: https://figurewell-api.cybermaxtools.com/mcp", "contact": { "name": "CyberMax", "url": "https://cybermax-tools-cybermax.static.hf.space/" }, "license": { "name": "Proprietary (free tier + paid API keys)", "identifier": "LicenseRef-CyberMax" }, "x-x402": { "protocol": "x402", "versions": [ 1, 2 ], "scheme": "exact", "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "currency": "USDC", "price": { "perCallUsd": 0.004 }, "payPerCallEndpoints": [ "/x402/api/financials", "/x402/api/snapshot", "/x402/api/metric" ], "alsoOn": "the plain endpoints answer 402 with the same terms once the free daily quota is used up (no key sent)", "headers": { "request": [ "X-PAYMENT (v1)", "PAYMENT-SIGNATURE (v2)" ], "response": [ "X-PAYMENT-RESPONSE", "PAYMENT-RESPONSE" ] } }, "x-pricing": { "api": "Figurewell API API", "currency": "USD", "free": { "price": 0, "callsPerDayPerIp": 100, "perMinutePerIp": 10, "key": "none needed" }, "plans": [ { "id": "quant", "name": "Quant", "price": 19, "billing": "per month", "calls": 10000, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://figurewell-api.cybermaxtools.com/buy/quant?s=openapi" }, { "id": "research", "name": "Research", "price": 49, "billing": "per month", "calls": 50000, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://figurewell-api.cybermaxtools.com/buy/research?s=openapi" }, { "id": "fund", "name": "Fund", "price": 99, "billing": "per month", "calls": 150000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://figurewell-api.cybermaxtools.com/buy/fund?s=openapi" }, { "id": "payg", "name": "Pay as you go", "price": 5, "billing": "one-time", "calls": 1500, "per": "until used", "perMinute": 30, "buy": "https://figurewell-api.cybermaxtools.com/buy/payg?s=openapi" }, { "id": "quant-yearly", "name": "Quant yearly", "price": 190, "billing": "per year", "calls": 10000, "per": "calendar month (UTC)", "perMinute": 30, "buy": "https://figurewell-api.cybermaxtools.com/buy/quant-yearly?s=openapi" }, { "id": "research-yearly", "name": "Research yearly", "price": 490, "billing": "per year", "calls": 50000, "per": "calendar month (UTC)", "perMinute": 60, "buy": "https://figurewell-api.cybermaxtools.com/buy/research-yearly?s=openapi" }, { "id": "fund-yearly", "name": "Fund yearly", "price": 990, "billing": "per year", "calls": 150000, "per": "calendar month (UTC)", "perMinute": 120, "buy": "https://figurewell-api.cybermaxtools.com/buy/fund-yearly?s=openapi" } ], "unit": "calls", "howToUse": { "header": "x-api-key: YOUR_KEY", "alt": [ "Authorization: Bearer YOUR_KEY", "?key=YOUR_KEY" ], "mcp": "send the key as Authorization: Bearer YOUR_KEY", "usage": "https://figurewell-api.cybermaxtools.com/key" }, "manageKey": "https://figurewell-api.cybermaxtools.com/manage", "payments": "Stripe Checkout: card, Apple Pay, Google Pay, Link. Prices are in USD; where your country charges VAT or sales tax, Stripe adds it at checkout and shows it before you pay. Cancel any time at https://figurewell-api.cybermaxtools.com/manage." } }, "servers": [ { "url": "https://figurewell-api.cybermaxtools.com" }, { "url": "https://figurewell-api.cybermax-tools.workers.dev" } ], "paths": { "/api/financials": { "get": { "tags": [ "Figurewell API" ], "summary": "Every filing's key metrics as first reported, known as of a date", "description": "One row per 10-K, 10-Q, 20-F or 40-F the company filed, newest accepted first, with the metrics exactly as that filing reported them for its own period: revenue, cost of revenue, gross profit, operating income, net income, EPS basic/diluted, diluted shares, total/current assets and liabilities, equity, cash, long-term debt, operating cash flow, capex and dividends (year to date), free cash flow, margins; plus fiscal year/period, period end, filed date, EDGAR acceptance time (UTC and New York), after_close, amended_later, the tags used and the filing link. as_of keeps only filings accepted by then.", "operationId": "financialsAsOfGet", "parameters": [ { "name": "ticker", "in": "query", "required": false, "description": "Stock ticker (e.g. AAPL). Or use cik", "schema": { "type": "string" }, "example": "AAPL" }, { "name": "cik", "in": "query", "required": false, "description": "SEC CIK number, for companies without a listed ticker", "schema": { "type": "string" }, "example": "" }, { "name": "as_of", "in": "query", "required": false, "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", "schema": { "type": "string" }, "example": "2024-06-30" }, { "name": "form", "in": "query", "required": false, "description": "all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)", "schema": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all" } }, { "name": "amendments", "in": "query", "required": false, "description": "Include 10-K/A and 10-Q/A amendments (default false)", "schema": { "type": "boolean", "default": false } }, { "name": "fields", "in": "query", "required": false, "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", "schema": { "type": "string" }, "example": "" }, { "name": "limit", "in": "query", "required": false, "description": "Filings, newest accepted first (1-40)", "schema": { "type": "integer", "default": 8 } }, { "name": "offset", "in": "query", "required": false, "description": "Skip filings (paging)", "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "company": { "cik": "320193", "name": "Apple Inc.", "tickers": [ "AAPL" ], "sic": "3571", "sic_description": "Electronic Computers", "fiscal_year_end": "0926", "acceptance_checks": [ { "page": "recent", "checks": [ { "accession": "0000320193-26-000020", "form": "10-Q", "edgar_header_et": "20260731060102", "submissions_json": "2026-07-31T14:01:02.000Z", "mode": "shifted" } ] } ], "cached_at": "2026-10-08T12:37:42.476Z", "ticker": "AAPL" }, "query": { "as_of": "2025-10-31T03:59:59.000Z", "form": "all", "amendments": false, "limit": 4, "offset": 0 }, "count": 4, "total": 65, "filings": [ { "accession": "0000320193-25-000073", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q3", "period_end": "2025-06-28", "filed_date": "2025-08-01", "accepted_utc": "2025-08-01T10:00:42Z", "revenue": 94036000000, "cost_of_revenue": 50318000000, "gross_profit": 43718000000, "operating_income": 28202000000, "net_income": 23434000000, "eps_basic": 1.57, "eps_diluted": 1.57, "diluted_shares": 14948179000, "total_assets": 331495000000, "current_assets": 122491000000, "total_liabilities": 265665000000, "current_liabilities": 141120000000, "stockholders_equity": 65830000000, "cash": 36269000000, "long_term_debt": 82430000000, "operating_cash_flow_ytd": 81754000000, "cash_flow_quarters": 3, "capex_ytd": 9473000000, "dividends_paid_ytd": 11559000000, "currency": "USD", "free_cash_flow_ytd": 72281000000, "gross_margin": 0.4649, "net_margin": 0.2492, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-08-01T06:00:42-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000073/0000320193-25-000073-index.htm" }, { "accession": "0000320193-25-000057", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q2", "period_end": "2025-03-29", "filed_date": "2025-05-02", "accepted_utc": "2025-05-02T10:00:46Z", "revenue": 95359000000, "cost_of_revenue": 50492000000, "gross_profit": 44867000000, "operating_income": 29589000000, "net_income": 24780000000, "eps_basic": 1.65, "eps_diluted": 1.65, "diluted_shares": 15056133000, "total_assets": 331233000000, "current_assets": 118674000000, "total_liabilities": 264437000000, "current_liabilities": 144571000000, "stockholders_equity": 66796000000, "cash": 28162000000, "long_term_debt": 78566000000, "operating_cash_flow_ytd": 53887000000, "cash_flow_quarters": 2, "capex_ytd": 6011000000, "dividends_paid_ytd": 7614000000, "currency": "USD", "free_cash_flow_ytd": 47876000000, "gross_margin": 0.4705, "net_margin": 0.2599, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-05-02T06:00:46-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000057/0000320193-25-000057-index.htm" }, { "accession": "0000320193-25-000008", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q1", "period_end": "2024-12-28", "filed_date": "2025-01-31", "accepted_utc": "2025-01-31T11:01:27Z", "revenue": 124300000000, "cost_of_revenue": 66025000000, "gross_profit": 58275000000, "operating_income": 42832000000, "net_income": 36330000000, "eps_basic": 2.41, "eps_diluted": 2.4, "diluted_shares": 15150865000, "total_assets": 344085000000, "current_assets": 133240000000, "total_liabilities": 277327000000, "current_liabilities": 144365000000, "stockholders_equity": 66758000000, "cash": 30299000000, "long_term_debt": 83956000000, "operating_cash_flow_ytd": 29935000000, "cash_flow_quarters": 1, "capex_ytd": 2940000000, "dividends_paid_ytd": 3856000000, "currency": "USD", "free_cash_flow_ytd": 26995000000, "gross_margin": 0.4688, "net_margin": 0.2923, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-01-31T06:01:27-05:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.htm" }, { "accession": "0000320193-24-000123", "cik": "320193", "form": "10-K", "fiscal_year": 2024, "fiscal_period": "FY", "period_end": "2024-09-28", "filed_date": "2024-11-01", "accepted_utc": "2024-11-01T10:01:36Z", "revenue": 391035000000, "cost_of_revenue": 210352000000, "gross_profit": 180683000000, "operating_income": 123216000000, "net_income": 93736000000, "eps_basic": 6.11, "eps_diluted": 6.08, "diluted_shares": 15408095000, "total_assets": 364980000000, "current_assets": 152987000000, "total_liabilities": 308030000000, "current_liabilities": 176392000000, "stockholders_equity": 56950000000, "cash": 29943000000, "long_term_debt": 85750000000, "operating_cash_flow_ytd": 118254000000, "cash_flow_quarters": 4, "capex_ytd": 9447000000, "dividends_paid_ytd": 15234000000, "currency": "USD", "free_cash_flow_ytd": 108807000000, "gross_margin": 0.4621, "net_margin": 0.2397, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2024-11-01T06:01:36-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm" } ], "rule": "Point-in-time: rows are filings EDGAR had accepted on or before as_of (accepted_utc; a bare date means 23:59:59 New York time that day). Values are as that filing reported them, never later restatements. after_close = accepted at or after 4 pm ET, so tradable from the next session.", "data": { "source": "SEC EDGAR XBRL companyfacts + submissions index (public domain)", "company_cached_at": "2026-10-08T12:37:42.476Z", "refresh": "each company is re-read from EDGAR at most every 12 hours" }, "disclaimer": "Information only, not investment advice. Data: SEC EDGAR XBRL filings (public domain), as filed; not affiliated with or endorsed by the SEC." } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Figurewell API" ], "summary": "Every filing's key metrics as first reported, known as of a date", "description": "One row per 10-K, 10-Q, 20-F or 40-F the company filed, newest accepted first, with the metrics exactly as that filing reported them for its own period: revenue, cost of revenue, gross profit, operating income, net income, EPS basic/diluted, diluted shares, total/current assets and liabilities, equity, cash, long-term debt, operating cash flow, capex and dividends (year to date), free cash flow, margins; plus fiscal year/period, period end, filed date, EDGAR acceptance time (UTC and New York), after_close, amended_later, the tags used and the filing link. as_of keeps only filings accepted by then.", "operationId": "financialsAsOfPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ticker": { "type": "string", "description": "Stock ticker (e.g. AAPL). Or use cik" }, "cik": { "type": "string", "description": "SEC CIK number, for companies without a listed ticker" }, "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" }, "form": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all", "description": "all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)" }, "amendments": { "type": "boolean", "default": false, "description": "Include 10-K/A and 10-Q/A amendments (default false)" }, "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" }, "limit": { "type": "integer", "default": 8, "description": "Filings, newest accepted first (1-40)" }, "offset": { "type": "integer", "default": 0, "description": "Skip filings (paging)" } } }, "example": { "ticker": "AAPL", "as_of": "2024-06-30", "form": "quarterly", "limit": 4 } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "company": { "cik": "320193", "name": "Apple Inc.", "tickers": [ "AAPL" ], "sic": "3571", "sic_description": "Electronic Computers", "fiscal_year_end": "0926", "acceptance_checks": [ { "page": "recent", "checks": [ { "accession": "0000320193-26-000020", "form": "10-Q", "edgar_header_et": "20260731060102", "submissions_json": "2026-07-31T14:01:02.000Z", "mode": "shifted" } ] } ], "cached_at": "2026-10-08T12:37:42.476Z", "ticker": "AAPL" }, "query": { "as_of": "2025-10-31T03:59:59.000Z", "form": "all", "amendments": false, "limit": 4, "offset": 0 }, "count": 4, "total": 65, "filings": [ { "accession": "0000320193-25-000073", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q3", "period_end": "2025-06-28", "filed_date": "2025-08-01", "accepted_utc": "2025-08-01T10:00:42Z", "revenue": 94036000000, "cost_of_revenue": 50318000000, "gross_profit": 43718000000, "operating_income": 28202000000, "net_income": 23434000000, "eps_basic": 1.57, "eps_diluted": 1.57, "diluted_shares": 14948179000, "total_assets": 331495000000, "current_assets": 122491000000, "total_liabilities": 265665000000, "current_liabilities": 141120000000, "stockholders_equity": 65830000000, "cash": 36269000000, "long_term_debt": 82430000000, "operating_cash_flow_ytd": 81754000000, "cash_flow_quarters": 3, "capex_ytd": 9473000000, "dividends_paid_ytd": 11559000000, "currency": "USD", "free_cash_flow_ytd": 72281000000, "gross_margin": 0.4649, "net_margin": 0.2492, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-08-01T06:00:42-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000073/0000320193-25-000073-index.htm" }, { "accession": "0000320193-25-000057", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q2", "period_end": "2025-03-29", "filed_date": "2025-05-02", "accepted_utc": "2025-05-02T10:00:46Z", "revenue": 95359000000, "cost_of_revenue": 50492000000, "gross_profit": 44867000000, "operating_income": 29589000000, "net_income": 24780000000, "eps_basic": 1.65, "eps_diluted": 1.65, "diluted_shares": 15056133000, "total_assets": 331233000000, "current_assets": 118674000000, "total_liabilities": 264437000000, "current_liabilities": 144571000000, "stockholders_equity": 66796000000, "cash": 28162000000, "long_term_debt": 78566000000, "operating_cash_flow_ytd": 53887000000, "cash_flow_quarters": 2, "capex_ytd": 6011000000, "dividends_paid_ytd": 7614000000, "currency": "USD", "free_cash_flow_ytd": 47876000000, "gross_margin": 0.4705, "net_margin": 0.2599, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-05-02T06:00:46-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000057/0000320193-25-000057-index.htm" }, { "accession": "0000320193-25-000008", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q1", "period_end": "2024-12-28", "filed_date": "2025-01-31", "accepted_utc": "2025-01-31T11:01:27Z", "revenue": 124300000000, "cost_of_revenue": 66025000000, "gross_profit": 58275000000, "operating_income": 42832000000, "net_income": 36330000000, "eps_basic": 2.41, "eps_diluted": 2.4, "diluted_shares": 15150865000, "total_assets": 344085000000, "current_assets": 133240000000, "total_liabilities": 277327000000, "current_liabilities": 144365000000, "stockholders_equity": 66758000000, "cash": 30299000000, "long_term_debt": 83956000000, "operating_cash_flow_ytd": 29935000000, "cash_flow_quarters": 1, "capex_ytd": 2940000000, "dividends_paid_ytd": 3856000000, "currency": "USD", "free_cash_flow_ytd": 26995000000, "gross_margin": 0.4688, "net_margin": 0.2923, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-01-31T06:01:27-05:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.htm" }, { "accession": "0000320193-24-000123", "cik": "320193", "form": "10-K", "fiscal_year": 2024, "fiscal_period": "FY", "period_end": "2024-09-28", "filed_date": "2024-11-01", "accepted_utc": "2024-11-01T10:01:36Z", "revenue": 391035000000, "cost_of_revenue": 210352000000, "gross_profit": 180683000000, "operating_income": 123216000000, "net_income": 93736000000, "eps_basic": 6.11, "eps_diluted": 6.08, "diluted_shares": 15408095000, "total_assets": 364980000000, "current_assets": 152987000000, "total_liabilities": 308030000000, "current_liabilities": 176392000000, "stockholders_equity": 56950000000, "cash": 29943000000, "long_term_debt": 85750000000, "operating_cash_flow_ytd": 118254000000, "cash_flow_quarters": 4, "capex_ytd": 9447000000, "dividends_paid_ytd": 15234000000, "currency": "USD", "free_cash_flow_ytd": 108807000000, "gross_margin": 0.4621, "net_margin": 0.2397, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2024-11-01T06:01:36-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm" } ], "rule": "Point-in-time: rows are filings EDGAR had accepted on or before as_of (accepted_utc; a bare date means 23:59:59 New York time that day). Values are as that filing reported them, never later restatements. after_close = accepted at or after 4 pm ET, so tradable from the next session.", "data": { "source": "SEC EDGAR XBRL companyfacts + submissions index (public domain)", "company_cached_at": "2026-10-08T12:37:42.476Z", "refresh": "each company is re-read from EDGAR at most every 12 hours" }, "disclaimer": "Information only, not investment advice. Data: SEC EDGAR XBRL filings (public domain), as filed; not affiliated with or endorsed by the SEC." } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/snapshot": { "get": { "tags": [ "Figurewell API" ], "summary": "Latest filing per company as of a date (up to 10 tickers)", "description": "For each ticker, the newest periodic filing EDGAR had accepted by as_of, with all key metrics as first reported: a point-in-time cross-section for screens and backtests.", "operationId": "snapshotAsOfGet", "parameters": [ { "name": "tickers", "in": "query", "required": false, "description": "Up to 10 tickers, comma separated (or cik=)", "schema": { "type": "string" }, "example": "AAPL,MSFT,NVDA" }, { "name": "as_of", "in": "query", "required": false, "description": "Point in time (YYYY-MM-DD = end of that day, New York). Empty = now", "schema": { "type": "string" }, "example": "2023-01-31" }, { "name": "form", "in": "query", "required": false, "description": "all, annual or quarterly", "schema": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all" } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Figurewell API" ], "summary": "Latest filing per company as of a date (up to 10 tickers)", "description": "For each ticker, the newest periodic filing EDGAR had accepted by as_of, with all key metrics as first reported: a point-in-time cross-section for screens and backtests.", "operationId": "snapshotAsOfPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tickers": { "type": "string", "description": "Up to 10 tickers, comma separated (or cik=)" }, "as_of": { "type": "string", "description": "Point in time (YYYY-MM-DD = end of that day, New York). Empty = now" }, "form": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all", "description": "all, annual or quarterly" } } }, "example": { "tickers": "AAPL,MSFT,NVDA", "as_of": "2025-06-30" } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/metric": { "get": { "tags": [ "Figurewell API" ], "summary": "One metric's history: first reported vs latest, restatements flagged", "description": "Every period a company reported for one metric, newest first: the value as first reported (filing, acceptance time), the newest value known at as_of, how many filings reported it and whether it was ever restated.", "operationId": "metricHistoryGet", "parameters": [ { "name": "ticker", "in": "query", "required": false, "description": "Stock ticker (or cik=)", "schema": { "type": "string" }, "example": "AAPL" }, { "name": "metric", "in": "query", "required": false, "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", "schema": { "type": "string", "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" ], "default": "revenue" }, "example": "revenue" }, { "name": "period", "in": "query", "required": false, "description": "quarter, annual, ytd or instant (default: the metric's own kind)", "schema": { "type": "string", "enum": [ "quarter", "annual", "ytd", "instant" ] } }, { "name": "as_of", "in": "query", "required": false, "description": "Only what was public by then (YYYY-MM-DD or ISO time)", "schema": { "type": "string" }, "example": "" }, { "name": "limit", "in": "query", "required": false, "description": "Periods, newest first (1-80)", "schema": { "type": "integer", "default": 12 } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Figurewell API" ], "summary": "One metric's history: first reported vs latest, restatements flagged", "description": "Every period a company reported for one metric, newest first: the value as first reported (filing, acceptance time), the newest value known at as_of, how many filings reported it and whether it was ever restated.", "operationId": "metricHistoryPost", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ticker": { "type": "string", "description": "Stock ticker (or cik=)" }, "metric": { "type": "string", "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" ], "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": { "type": "string", "enum": [ "quarter", "annual", "ytd", "instant" ], "description": "quarter, annual, ytd or instant (default: the metric's own kind)" }, "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)" } } }, "example": { "ticker": "AAPL", "metric": "net_income", "period": "annual" } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Free tier used up (100/day per IP) or rate/plan limit reached; the body has an upgrade link.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/x402/api/financials": { "get": { "tags": [ "Figurewell API" ], "summary": "Every filing's key metrics as first reported, known as of a date (pay per call in USDC via x402, no key)", "description": "One row per 10-K, 10-Q, 20-F or 40-F the company filed, newest accepted first, with the metrics exactly as that filing reported them for its own period: revenue, cost of revenue, gross profit, operating income, net income, EPS basic/diluted, diluted shares, total/current assets and liabilities, equity, cash, long-term debt, operating cash flow, capex and dividends (year to date), free cash flow, margins; plus fiscal year/period, period end, filed date, EDGAR acceptance time (UTC and New York), after_close, amended_later, the tags used and the filing link. as_of keeps only filings accepted by then.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "financialsAsOfGetPayPerCall", "parameters": [ { "name": "ticker", "in": "query", "required": false, "description": "Stock ticker (e.g. AAPL). Or use cik", "schema": { "type": "string" }, "example": "AAPL" }, { "name": "cik", "in": "query", "required": false, "description": "SEC CIK number, for companies without a listed ticker", "schema": { "type": "string" }, "example": "" }, { "name": "as_of", "in": "query", "required": false, "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", "schema": { "type": "string" }, "example": "2024-06-30" }, { "name": "form", "in": "query", "required": false, "description": "all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)", "schema": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all" } }, { "name": "amendments", "in": "query", "required": false, "description": "Include 10-K/A and 10-Q/A amendments (default false)", "schema": { "type": "boolean", "default": false } }, { "name": "fields", "in": "query", "required": false, "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", "schema": { "type": "string" }, "example": "" }, { "name": "limit", "in": "query", "required": false, "description": "Filings, newest accepted first (1-40)", "schema": { "type": "integer", "default": 8 } }, { "name": "offset", "in": "query", "required": false, "description": "Skip filings (paging)", "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "company": { "cik": "320193", "name": "Apple Inc.", "tickers": [ "AAPL" ], "sic": "3571", "sic_description": "Electronic Computers", "fiscal_year_end": "0926", "acceptance_checks": [ { "page": "recent", "checks": [ { "accession": "0000320193-26-000020", "form": "10-Q", "edgar_header_et": "20260731060102", "submissions_json": "2026-07-31T14:01:02.000Z", "mode": "shifted" } ] } ], "cached_at": "2026-10-08T12:37:42.476Z", "ticker": "AAPL" }, "query": { "as_of": "2025-10-31T03:59:59.000Z", "form": "all", "amendments": false, "limit": 4, "offset": 0 }, "count": 4, "total": 65, "filings": [ { "accession": "0000320193-25-000073", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q3", "period_end": "2025-06-28", "filed_date": "2025-08-01", "accepted_utc": "2025-08-01T10:00:42Z", "revenue": 94036000000, "cost_of_revenue": 50318000000, "gross_profit": 43718000000, "operating_income": 28202000000, "net_income": 23434000000, "eps_basic": 1.57, "eps_diluted": 1.57, "diluted_shares": 14948179000, "total_assets": 331495000000, "current_assets": 122491000000, "total_liabilities": 265665000000, "current_liabilities": 141120000000, "stockholders_equity": 65830000000, "cash": 36269000000, "long_term_debt": 82430000000, "operating_cash_flow_ytd": 81754000000, "cash_flow_quarters": 3, "capex_ytd": 9473000000, "dividends_paid_ytd": 11559000000, "currency": "USD", "free_cash_flow_ytd": 72281000000, "gross_margin": 0.4649, "net_margin": 0.2492, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-08-01T06:00:42-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000073/0000320193-25-000073-index.htm" }, { "accession": "0000320193-25-000057", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q2", "period_end": "2025-03-29", "filed_date": "2025-05-02", "accepted_utc": "2025-05-02T10:00:46Z", "revenue": 95359000000, "cost_of_revenue": 50492000000, "gross_profit": 44867000000, "operating_income": 29589000000, "net_income": 24780000000, "eps_basic": 1.65, "eps_diluted": 1.65, "diluted_shares": 15056133000, "total_assets": 331233000000, "current_assets": 118674000000, "total_liabilities": 264437000000, "current_liabilities": 144571000000, "stockholders_equity": 66796000000, "cash": 28162000000, "long_term_debt": 78566000000, "operating_cash_flow_ytd": 53887000000, "cash_flow_quarters": 2, "capex_ytd": 6011000000, "dividends_paid_ytd": 7614000000, "currency": "USD", "free_cash_flow_ytd": 47876000000, "gross_margin": 0.4705, "net_margin": 0.2599, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-05-02T06:00:46-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000057/0000320193-25-000057-index.htm" }, { "accession": "0000320193-25-000008", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q1", "period_end": "2024-12-28", "filed_date": "2025-01-31", "accepted_utc": "2025-01-31T11:01:27Z", "revenue": 124300000000, "cost_of_revenue": 66025000000, "gross_profit": 58275000000, "operating_income": 42832000000, "net_income": 36330000000, "eps_basic": 2.41, "eps_diluted": 2.4, "diluted_shares": 15150865000, "total_assets": 344085000000, "current_assets": 133240000000, "total_liabilities": 277327000000, "current_liabilities": 144365000000, "stockholders_equity": 66758000000, "cash": 30299000000, "long_term_debt": 83956000000, "operating_cash_flow_ytd": 29935000000, "cash_flow_quarters": 1, "capex_ytd": 2940000000, "dividends_paid_ytd": 3856000000, "currency": "USD", "free_cash_flow_ytd": 26995000000, "gross_margin": 0.4688, "net_margin": 0.2923, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-01-31T06:01:27-05:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.htm" }, { "accession": "0000320193-24-000123", "cik": "320193", "form": "10-K", "fiscal_year": 2024, "fiscal_period": "FY", "period_end": "2024-09-28", "filed_date": "2024-11-01", "accepted_utc": "2024-11-01T10:01:36Z", "revenue": 391035000000, "cost_of_revenue": 210352000000, "gross_profit": 180683000000, "operating_income": 123216000000, "net_income": 93736000000, "eps_basic": 6.11, "eps_diluted": 6.08, "diluted_shares": 15408095000, "total_assets": 364980000000, "current_assets": 152987000000, "total_liabilities": 308030000000, "current_liabilities": 176392000000, "stockholders_equity": 56950000000, "cash": 29943000000, "long_term_debt": 85750000000, "operating_cash_flow_ytd": 118254000000, "cash_flow_quarters": 4, "capex_ytd": 9447000000, "dividends_paid_ytd": 15234000000, "currency": "USD", "free_cash_flow_ytd": 108807000000, "gross_margin": 0.4621, "net_margin": 0.2397, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2024-11-01T06:01:36-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm" } ], "rule": "Point-in-time: rows are filings EDGAR had accepted on or before as_of (accepted_utc; a bare date means 23:59:59 New York time that day). Values are as that filing reported them, never later restatements. after_close = accepted at or after 4 pm ET, so tradable from the next session.", "data": { "source": "SEC EDGAR XBRL companyfacts + submissions index (public domain)", "company_cached_at": "2026-10-08T12:37:42.476Z", "refresh": "each company is re-read from EDGAR at most every 12 hours" }, "disclaimer": "Information only, not investment advice. Data: SEC EDGAR XBRL filings (public domain), as filed; not affiliated with or endorsed by the SEC." } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } }, "post": { "tags": [ "Figurewell API" ], "summary": "Every filing's key metrics as first reported, known as of a date (pay per call in USDC via x402, no key)", "description": "One row per 10-K, 10-Q, 20-F or 40-F the company filed, newest accepted first, with the metrics exactly as that filing reported them for its own period: revenue, cost of revenue, gross profit, operating income, net income, EPS basic/diluted, diluted shares, total/current assets and liabilities, equity, cash, long-term debt, operating cash flow, capex and dividends (year to date), free cash flow, margins; plus fiscal year/period, period end, filed date, EDGAR acceptance time (UTC and New York), after_close, amended_later, the tags used and the filing link. as_of keeps only filings accepted by then.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "financialsAsOfPostPayPerCall", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ticker": { "type": "string", "description": "Stock ticker (e.g. AAPL). Or use cik" }, "cik": { "type": "string", "description": "SEC CIK number, for companies without a listed ticker" }, "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" }, "form": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all", "description": "all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)" }, "amendments": { "type": "boolean", "default": false, "description": "Include 10-K/A and 10-Q/A amendments (default false)" }, "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" }, "limit": { "type": "integer", "default": 8, "description": "Filings, newest accepted first (1-40)" }, "offset": { "type": "integer", "default": 0, "description": "Skip filings (paging)" } } }, "example": { "ticker": "AAPL", "as_of": "2024-06-30", "form": "quarterly", "limit": 4 } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "company": { "cik": "320193", "name": "Apple Inc.", "tickers": [ "AAPL" ], "sic": "3571", "sic_description": "Electronic Computers", "fiscal_year_end": "0926", "acceptance_checks": [ { "page": "recent", "checks": [ { "accession": "0000320193-26-000020", "form": "10-Q", "edgar_header_et": "20260731060102", "submissions_json": "2026-07-31T14:01:02.000Z", "mode": "shifted" } ] } ], "cached_at": "2026-10-08T12:37:42.476Z", "ticker": "AAPL" }, "query": { "as_of": "2025-10-31T03:59:59.000Z", "form": "all", "amendments": false, "limit": 4, "offset": 0 }, "count": 4, "total": 65, "filings": [ { "accession": "0000320193-25-000073", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q3", "period_end": "2025-06-28", "filed_date": "2025-08-01", "accepted_utc": "2025-08-01T10:00:42Z", "revenue": 94036000000, "cost_of_revenue": 50318000000, "gross_profit": 43718000000, "operating_income": 28202000000, "net_income": 23434000000, "eps_basic": 1.57, "eps_diluted": 1.57, "diluted_shares": 14948179000, "total_assets": 331495000000, "current_assets": 122491000000, "total_liabilities": 265665000000, "current_liabilities": 141120000000, "stockholders_equity": 65830000000, "cash": 36269000000, "long_term_debt": 82430000000, "operating_cash_flow_ytd": 81754000000, "cash_flow_quarters": 3, "capex_ytd": 9473000000, "dividends_paid_ytd": 11559000000, "currency": "USD", "free_cash_flow_ytd": 72281000000, "gross_margin": 0.4649, "net_margin": 0.2492, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-08-01T06:00:42-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000073/0000320193-25-000073-index.htm" }, { "accession": "0000320193-25-000057", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q2", "period_end": "2025-03-29", "filed_date": "2025-05-02", "accepted_utc": "2025-05-02T10:00:46Z", "revenue": 95359000000, "cost_of_revenue": 50492000000, "gross_profit": 44867000000, "operating_income": 29589000000, "net_income": 24780000000, "eps_basic": 1.65, "eps_diluted": 1.65, "diluted_shares": 15056133000, "total_assets": 331233000000, "current_assets": 118674000000, "total_liabilities": 264437000000, "current_liabilities": 144571000000, "stockholders_equity": 66796000000, "cash": 28162000000, "long_term_debt": 78566000000, "operating_cash_flow_ytd": 53887000000, "cash_flow_quarters": 2, "capex_ytd": 6011000000, "dividends_paid_ytd": 7614000000, "currency": "USD", "free_cash_flow_ytd": 47876000000, "gross_margin": 0.4705, "net_margin": 0.2599, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-05-02T06:00:46-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000057/0000320193-25-000057-index.htm" }, { "accession": "0000320193-25-000008", "cik": "320193", "form": "10-Q", "fiscal_year": 2025, "fiscal_period": "Q1", "period_end": "2024-12-28", "filed_date": "2025-01-31", "accepted_utc": "2025-01-31T11:01:27Z", "revenue": 124300000000, "cost_of_revenue": 66025000000, "gross_profit": 58275000000, "operating_income": 42832000000, "net_income": 36330000000, "eps_basic": 2.41, "eps_diluted": 2.4, "diluted_shares": 15150865000, "total_assets": 344085000000, "current_assets": 133240000000, "total_liabilities": 277327000000, "current_liabilities": 144365000000, "stockholders_equity": 66758000000, "cash": 30299000000, "long_term_debt": 83956000000, "operating_cash_flow_ytd": 29935000000, "cash_flow_quarters": 1, "capex_ytd": 2940000000, "dividends_paid_ytd": 3856000000, "currency": "USD", "free_cash_flow_ytd": 26995000000, "gross_margin": 0.4688, "net_margin": 0.2923, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2025-01-31T06:01:27-05:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000008/0000320193-25-000008-index.htm" }, { "accession": "0000320193-24-000123", "cik": "320193", "form": "10-K", "fiscal_year": 2024, "fiscal_period": "FY", "period_end": "2024-09-28", "filed_date": "2024-11-01", "accepted_utc": "2024-11-01T10:01:36Z", "revenue": 391035000000, "cost_of_revenue": 210352000000, "gross_profit": 180683000000, "operating_income": 123216000000, "net_income": 93736000000, "eps_basic": 6.11, "eps_diluted": 6.08, "diluted_shares": 15408095000, "total_assets": 364980000000, "current_assets": 152987000000, "total_liabilities": 308030000000, "current_liabilities": 176392000000, "stockholders_equity": 56950000000, "cash": 29943000000, "long_term_debt": 85750000000, "operating_cash_flow_ytd": 118254000000, "cash_flow_quarters": 4, "capex_ytd": 9447000000, "dividends_paid_ytd": 15234000000, "currency": "USD", "free_cash_flow_ytd": 108807000000, "gross_margin": 0.4621, "net_margin": 0.2397, "tags_used": { "revenue": "RevenueFromContractWithCustomerExcludingAssessedTax", "cost_of_revenue": "CostOfGoodsAndServicesSold", "gross_profit": "GrossProfit", "operating_income": "OperatingIncomeLoss", "net_income": "NetIncomeLoss", "eps_basic": "EarningsPerShareBasic", "eps_diluted": "EarningsPerShareDiluted", "diluted_shares": "WeightedAverageNumberOfDilutedSharesOutstanding", "total_assets": "Assets", "current_assets": "AssetsCurrent", "total_liabilities": "Liabilities", "current_liabilities": "LiabilitiesCurrent", "stockholders_equity": "StockholdersEquity", "cash": "CashAndCashEquivalentsAtCarryingValue", "long_term_debt": "LongTermDebtNoncurrent", "operating_cash_flow_ytd": "NetCashProvidedByUsedInOperatingActivities", "capex_ytd": "PaymentsToAcquirePropertyPlantAndEquipment", "dividends_paid_ytd": "PaymentsOfDividends" }, "amended_later": false, "accepted_et": "2024-11-01T06:01:36-04:00", "after_close": false, "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm" } ], "rule": "Point-in-time: rows are filings EDGAR had accepted on or before as_of (accepted_utc; a bare date means 23:59:59 New York time that day). Values are as that filing reported them, never later restatements. after_close = accepted at or after 4 pm ET, so tradable from the next session.", "data": { "source": "SEC EDGAR XBRL companyfacts + submissions index (public domain)", "company_cached_at": "2026-10-08T12:37:42.476Z", "refresh": "each company is re-read from EDGAR at most every 12 hours" }, "disclaimer": "Information only, not investment advice. Data: SEC EDGAR XBRL filings (public domain), as filed; not affiliated with or endorsed by the SEC." } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } } }, "/x402/api/snapshot": { "get": { "tags": [ "Figurewell API" ], "summary": "Latest filing per company as of a date (up to 10 tickers) (pay per call in USDC via x402, no key)", "description": "For each ticker, the newest periodic filing EDGAR had accepted by as_of, with all key metrics as first reported: a point-in-time cross-section for screens and backtests.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "snapshotAsOfGetPayPerCall", "parameters": [ { "name": "tickers", "in": "query", "required": false, "description": "Up to 10 tickers, comma separated (or cik=)", "schema": { "type": "string" }, "example": "AAPL,MSFT,NVDA" }, { "name": "as_of", "in": "query", "required": false, "description": "Point in time (YYYY-MM-DD = end of that day, New York). Empty = now", "schema": { "type": "string" }, "example": "2023-01-31" }, { "name": "form", "in": "query", "required": false, "description": "all, annual or quarterly", "schema": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all" } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } }, "post": { "tags": [ "Figurewell API" ], "summary": "Latest filing per company as of a date (up to 10 tickers) (pay per call in USDC via x402, no key)", "description": "For each ticker, the newest periodic filing EDGAR had accepted by as_of, with all key metrics as first reported: a point-in-time cross-section for screens and backtests.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "snapshotAsOfPostPayPerCall", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tickers": { "type": "string", "description": "Up to 10 tickers, comma separated (or cik=)" }, "as_of": { "type": "string", "description": "Point in time (YYYY-MM-DD = end of that day, New York). Empty = now" }, "form": { "type": "string", "enum": [ "all", "annual", "quarterly" ], "default": "all", "description": "all, annual or quarterly" } } }, "example": { "tickers": "AAPL,MSFT,NVDA", "as_of": "2025-06-30" } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } } }, "/x402/api/metric": { "get": { "tags": [ "Figurewell API" ], "summary": "One metric's history: first reported vs latest, restatements flagged (pay per call in USDC via x402, no key)", "description": "Every period a company reported for one metric, newest first: the value as first reported (filing, acceptance time), the newest value known at as_of, how many filings reported it and whether it was ever restated.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "metricHistoryGetPayPerCall", "parameters": [ { "name": "ticker", "in": "query", "required": false, "description": "Stock ticker (or cik=)", "schema": { "type": "string" }, "example": "AAPL" }, { "name": "metric", "in": "query", "required": false, "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", "schema": { "type": "string", "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" ], "default": "revenue" }, "example": "revenue" }, { "name": "period", "in": "query", "required": false, "description": "quarter, annual, ytd or instant (default: the metric's own kind)", "schema": { "type": "string", "enum": [ "quarter", "annual", "ytd", "instant" ] } }, { "name": "as_of", "in": "query", "required": false, "description": "Only what was public by then (YYYY-MM-DD or ISO time)", "schema": { "type": "string" }, "example": "" }, { "name": "limit", "in": "query", "required": false, "description": "Periods, newest first (1-80)", "schema": { "type": "integer", "default": 12 } } ], "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } }, "post": { "tags": [ "Figurewell API" ], "summary": "One metric's history: first reported vs latest, restatements flagged (pay per call in USDC via x402, no key)", "description": "Every period a company reported for one metric, newest first: the value as first reported (filing, acceptance time), the newest value known at as_of, how many filings reported it and whether it was ever restated.\n\nPay per call with x402: $0.004 per call in USDC on Base. No key, no account: an unpaid call returns 402 with the payment requirements; retry with the X-PAYMENT (x402 v1) or PAYMENT-SIGNATURE (v2) header.", "operationId": "metricHistoryPostPayPerCall", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ticker": { "type": "string", "description": "Stock ticker (or cik=)" }, "metric": { "type": "string", "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" ], "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": { "type": "string", "enum": [ "quarter", "annual", "ytd", "instant" ], "description": "quarter, annual, ytd or instant (default: the metric's own kind)" }, "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)" } } }, "example": { "ticker": "AAPL", "metric": "net_income", "period": "annual" } } } }, "responses": { "200": { "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or revoked API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Payment Required: x402 payment requirements (body: x402Version 1 accepts[]; header PAYMENT-REQUIRED: x402 v2)." }, "504": { "description": "Took too long; ask for fewer items", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.004" }, "protocols": [ { "x402": { "version": [ 1, 2 ], "network": [ "base", "eip155:8453" ], "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact" } } ] } } } }, "components": { "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "retryAfterSeconds": { "type": "integer" }, "limits": { "type": "object" } }, "required": [ "error", "message" ] } }, "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Optional. Paid plan key from https://figurewell-api.cybermaxtools.com/docs#pricing; leave out for the free tier." }, "BearerKey": { "type": "http", "scheme": "bearer", "description": "Same key as a Bearer token." } } }, "x-mcp-server": "https://figurewell-api.cybermaxtools.com/mcp", "externalDocs": { "description": "Get an API key (pricing)", "url": "https://figurewell-api.cybermaxtools.com/docs#pricing" }, "security": [ {}, { "ApiKeyHeader": [] }, { "BearerKey": [] } ] }