# Figurewell API: Point-in-Time SEC XBRL Financials

> Figurewell API: Point-in-Time SEC XBRL Financials is a paid API for AI agents from figurewell-api.cybermaxtools.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-12).

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.

## Facts

- Endpoint: GET https://figurewell-api.cybermaxtools.com/x402/api/financials?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/figurewell-api-point-in-time-sec-xbrl-financials-acd246cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pL3rpzaLljktmG8q_BvFz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability figurewell-api-point-in-time-sec-xbrl-financials-acd246cd
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/figurewell-api-point-in-time-sec-xbrl-financials-acd246cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from figurewell-api.cybermaxtools.com](https://www.zero.xyz/host/figurewell-api.cybermaxtools.com/llms.txt)