# x402stock Per-Period Financial Statements

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

Returns SEC-sourced financial statements (income statement, balance sheet, cash flow, comprehensive income) as fact_key→value maps for a given US-listed ticker, filtered by timeframe and period count.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/financials/{ticker}
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-per-period-financial-statements-36fefa7f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vUteXfDC5p7W0DqbDULAh

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 agents-x402stock-xyz-x402stock-per-period-financial-statements-36fefa7f
```

Example prompt: Pull the last 4 quarterly financial statements for TSLA — income statement, balance sheet, and cash flow — from SEC filings.

## When to prefer this

Choose this endpoint when you need structured, multi-statement financial data (income statement, balance sheet, cash flow, comprehensive income) for a specific US-listed company across multiple fiscal periods from SEC filings. It is ideal for fundamental analysis, valuation models, earnings trend tracking, or any agent workflow that needs official GAAP figures flattened into machine-readable key-value maps. Prefer this over the single-concept XBRL time-series endpoint when you need a full cross-section of all financial statement line items for one or more reporting periods at once.

## Known failure modes

- Invalid or unknown ticker symbol returns empty data or error
- Ticker not found in SEC EDGAR returns null CIK or empty reports array
- Requesting TTM for a company with insufficient filing history may return partial data
- limit exceeding 100 is rejected by schema validation
- Network or payment failure via x402 protocol returns no data
- Delisted or OTC tickers may not have SEC XBRL coverage

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

An array of financial report objects, each containing company name, CIK, timeframe, fiscal period/year, start and end dates, filing date, SEC source filing URL, and a 'statements' map where each key is a statement type (e.g. income_statement, balance_sheet) and each value is a flat fact_key→number map of all reported XBRL financial metrics for that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 4,
   "maximum": 100,
   "exclusiveMinimum": 0
  },
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  },
  "timeframe": {
   "enum": [
    "annual",
    "quarterly",
    "ttm"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "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": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "statements": {
        "type": "object",
        "propertyNames": {
         "type": "string"
        },
        "additionalProperties": {
         "type": "object",
         "propertyNames": {
          "type": "string"
         },
         "additionalProperties": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         }
        }
       },
       "filing_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "fiscal_year": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "company_name": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "fiscal_period": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "source_filing_url": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       }
      },
      "additionalP
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-per-period-financial-statements-36fefa7f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)