# Figurewell API by CyberMax

> 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.

> 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

Revenue, 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.

## API (free tier without a key; paid API keys for more)
- [/api/financials](https://figurewell-api.cybermaxtools.com/api/financials?ticker=AAPL&as_of=2025-10-30&form=annual&limit=2): Every filing's key metrics as first reported, known as of a date
- [/api/snapshot](https://figurewell-api.cybermaxtools.com/api/snapshot?tickers=AAPL,MSFT,NVDA&as_of=2025-06-30): Latest filing per company as of a date (up to 10 tickers)
- [/api/metric](https://figurewell-api.cybermaxtools.com/api/metric?ticker=AAPL&metric=revenue&period=annual): One metric's history: first reported vs latest, restatements flagged
- GET for simple calls, POST a JSON body for lists. Same field names as the bulk version's dataset records.
- OpenAPI 3.1: https://figurewell-api.cybermaxtools.com/openapi.json

## MCP (remote, streamable HTTP, no auth)
- Endpoint: https://figurewell-api.cybermaxtools.com/mcp
- `financials_as_of`: A company's 10-K/10-Q/20-F/40-F filings (newest accepted first, up to 40) with revenue, profit, EPS, cash, debt, cash flow and margins as each filing first reported them, EDGAR acceptance time and filing link. as_of = only filings accepted by then.
- `snapshot_as_of`: For up to 10 tickers, the newest filing EDGAR had accepted by as_of, with key metrics as first reported.
- `metric_history`: One metric per period, newest first: value as first reported (and when), latest value known at as_of, restated flag.

## Limits
- 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.

## More
- Health: https://figurewell-api.cybermaxtools.com/health
- All CyberMax tools: https://cybermax-tools-cybermax.static.hf.space/
- Up to 40 filings or 10 companies per call. For every company's latest four quarters as one Parquet file, use the free Figurewell dataset on Hugging Face.

## Pricing
- Free: 100 calls a day per IP, 10/min, no key.
- Quant: $19/month, 10,000 calls a month, 30/min. Buy: https://figurewell-api.cybermaxtools.com/buy/quant?s=llms
- Research: $49/month, 50,000 calls a month, 60/min. Buy: https://figurewell-api.cybermaxtools.com/buy/research?s=llms
- Fund: $99/month, 150,000 calls a month, 120/min. Buy: https://figurewell-api.cybermaxtools.com/buy/fund?s=llms
- Pay as you go: $5, 1,500 calls (one-time pack, no expiry), 30/min. Buy: https://figurewell-api.cybermaxtools.com/buy/payg?s=llms
- Quant yearly: $190/year, 10,000 calls a month, 30/min. Buy: https://figurewell-api.cybermaxtools.com/buy/quant-yearly?s=llms
- Research yearly: $490/year, 50,000 calls a month, 60/min. Buy: https://figurewell-api.cybermaxtools.com/buy/research-yearly?s=llms
- Fund yearly: $990/year, 150,000 calls a month, 120/min. Buy: https://figurewell-api.cybermaxtools.com/buy/fund-yearly?s=llms
- Use the key as `x-api-key: KEY` or `Authorization: Bearer KEY` (MCP too). Usage: https://figurewell-api.cybermaxtools.com/key. Machine-readable: https://figurewell-api.cybermaxtools.com/pricing.json

## Pay per call (x402, USDC on Base): for AI agents, no key, no account
- $0.004 per call, paid in USDC on Base (x402 "exact" scheme, v1 and v2).
- https://figurewell-api.cybermaxtools.com/x402/api/financials: same as /api/financials, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- https://figurewell-api.cybermaxtools.com/x402/api/snapshot: same as /api/snapshot, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- https://figurewell-api.cybermaxtools.com/x402/api/metric: same as /api/metric, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- Plain endpoints keep the free tier and API keys; with no key, they also answer 402 (instead of 429) once the free daily quota is used.
- Send the signed payment as X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2); the receipt comes back in X-PAYMENT-RESPONSE / PAYMENT-RESPONSE. Failed calls are not charged.