# x402stock.xyz Financial Statements API

> x402stock.xyz Financial Statements API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns multi-period financial statement data (income, balance sheet, cash flow) for a given stock ticker, with optional timeframe filtering.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/financials/AAPL
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-d9b9d420
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OyR0GFXm-leLVmQlovNLE

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 x402stock-xyz-d9b9d420
```

Example prompt: Can you pull the last 4 annual financial statements for AAPL — I want income, balance sheet, and cash flow data?

## When to prefer this

Use this endpoint when you need structured, multi-period financial statement data (income statement, balance sheet, cash flow) for a specific US-listed public company ticker. Prefer this over general search endpoints when you already know the ticker symbol and need quantitative financial metrics across fiscal periods. Ideal for financial analysis, screening, or building financial models.

## Known failure modes

- Invalid or unknown ticker symbol returns empty data or 404
- Unsupported timeframe enum value returns validation error
- Limit parameter of 0 or negative returns error (exclusiveMinimum: 0)
- Ticker with no filings in the requested timeframe returns empty reports array
- Network or payment (x402) failure results in no response

## How this service works

Per-period financial statements (income statement, balance sheet, cash flow, comprehensive income) sourced from SEC filings, flattened to fact_key → value maps. Pass `?timeframe=annual|quarterly|ttm` and `?limit=`. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

Returns a structured JSON object containing the ticker symbol, as-of date, source, and an array of financial reports. Each report includes company name, CIK, timeframe, fiscal period, fiscal year, start/end dates, filing date, source filing URL, and a statements object with financial line items (e.g. revenues, net income, assets, liabilities, cash flows) keyed by statement type and metric name.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 4,
   "timeframe": "annual"
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 4,
       "maximum": 100,
       "exclusiveMinimum": 0
      },
      "timeframe": {
       "enum": [
        "annual",
        "quarterly",
        "ttm"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "count",
        "reports"
       ],
       "properties": {
        "count": {
         "type": "number"
        },
        "reports": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "company_name",
           "cik",
           "timeframe",
           "fiscal_period",
           "fiscal_year",
           "start_date",
           "end_date",
           "filing_date",
           "source_filing_url",
           "statements"
          ],
          "properties": {
           "cik": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "end_date": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "timeframe": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "start_date": {
            "anyOf": [
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-d9b9d420/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)