# x402stock Historical Stock Splits

> x402stock Historical Stock Splits is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-14).

Returns historical stock split events for a US-listed ticker, including execution date, split type, and split ratio (from/to), ordered most recent first.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/splits/{ticker}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-historical-stock-splits-163d8ea7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iesM-DmAAtZ2p2FHvzOIy

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-historical-stock-splits-163d8ea7
```

Example prompt: What's the full stock split history for NVDA — give me the execution dates, split types, and ratios for all of them?

## When to prefer this

Use this endpoint when you need structured historical split event data for a US-listed stock, including exact execution dates and numeric from/to ratios. Prefer this over general financial data APIs when you need machine-readable split ratios for price adjustment calculations, want split type classification (forward/reverse/even), or are building an agent workflow that requires no API key — paying per call in USDC via x402.

## Known failure modes

- Invalid or unknown ticker returns an error or empty splits array
- Ticker must be uppercase US-listed symbol; lowercase or foreign tickers may fail
- limit parameter of 0 or negative is rejected (exclusiveMinimum: 0)
- Payment failure via x402 if agent wallet has insufficient USDC
- Network timeout or upstream data provider unavailability

## How this service works

Historical stock splits for a ticker, with execution date and split ratio (split_from to split_to). Most recent first. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

A JSON object containing the ticker symbol, a timestamp (as_of), and a data object with the count of splits and an array of split events. Each split event includes: execution_date (string or null), type (forward, reverse, or even), split_from (number), split_to (number), ratio (number or null), and ratio_text (human-readable string like '2:1'). Results are sorted most recent first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 1000,
   "exclusiveMinimum": 0
  },
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "data",
  "source",
  "as_of"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "count",
    "splits"
   ],
   "properties": {
    "count": {
     "type": "number"
    },
    "splits": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "execution_date",
       "type",
       "split_from",
       "split_to",
       "ratio",
       "ratio_text"
      ],
      "properties": {
       "type": {
        "enum": [
         "forward",
         "reverse",
         "even"
        ],
        "type": "string"
       },
       "ratio": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       },
       "split_to": {
        "type": "number"
       },
       "ratio_text": {
        "type": "string"
       },
       "split_from": {
        "type": "number"
       },
       "execution_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       }
      },
      "additionalProperties": false
     }
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "ticker": {
   "type": "string"
  },
  "feedback": {
   "type": "object",
   "required": [
    "endpoint",
    "method",
    "free",
    "note"
   ],
   "properties": {
    "free": {
     "type": "boolean"
    },
    "note": {
     "type": "string"
    },
    "method": {
     "type": "string",
     "const": "POST"
    },
    "endpoint": {
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-historical-stock-splits-163d8ea7/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)