# x402stock Financial Statements API

> x402stock 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-15).

Retrieves financial statements (income statement, cash flow, balance sheet) for a US stock ticker, with support for annual, quarterly, or TTM timeframes

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/financials/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-financial-statements-api-defead64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7yl2--c0D5P_5yjc-BoBu

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-financial-statements-api-defead64
```

Example prompt: Pull the trailing twelve month financial statements for AAPL — I want revenues, net income, and cash flow for the most recent report.

## When to prefer this

Use this endpoint when you need structured financial statement data (income, cash flow, balance sheet) for US public companies by ticker, especially for AI agent workflows that require no API key setup and support pay-per-call USDC billing via x402 on Base. Prefer over alternatives when you need TTM (trailing twelve month) aggregated financials or want to avoid subscription commitments.

## Known failure modes

- Invalid or unknown ticker symbol returns empty or error response
- Timeframe parameter not recognized if misspelled
- Limit out of valid range (must be 1-100) causes validation error
- Payment failure in x402 protocol results in 402 response blocking data
- TTM data may have null filing_date and source_filing_url for computed periods
- Ticker with no SEC filing history may return empty reports array

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a structured JSON object containing financial statement data for the requested ticker, including income statement (revenues, net income), cash flow statement, and optionally balance sheet line items, along with fiscal period metadata (fiscal year, fiscal period, start/end dates, filing date), company name, CIK, and source filing URL. Covers up to 100 reports depending on the limit parameter.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "reports": [
    {
     "cik": "0000320193",
     "end_date": "2026-03-28",
     "timeframe": "ttm",
     "start_date": "2025-03-29",
     "statements": {
      "income_statement": {
       "revenues": 408625000000,
       "net_income_loss": 123563000000
      },
      "cash_flow_statement": {
       "net_cash_flow": 17410000000
      }
     },
     "filing_date": null,
     "fiscal_year": null,
     "company_name": "APPLE INC",
     "fiscal_period": "TTM",
     "source_filing_url": null
    }
   ]
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-financial-statements-api-defead64/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)