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

Retrieves point-in-time SEC XBRL financial metrics for US public companies as first reported, with EDGAR acceptance timestamps and as_of filtering.

## Facts

- Endpoint: GET https://figurewell-api.cybermaxtools.com/x402/api/metric?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-608eca36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rW4aZFu2akhAIkO687idK

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-608eca36
```

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

## When to prefer this

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.

## Known failure modes

- 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

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

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.

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

## 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-608eca36/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)