# x402stock Splits Calendar

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

Returns a paginated calendar of upcoming and historical stock splits (forward, reverse, or even) with execution dates, ratios, and tickers.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/splits-calendar
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-splits-calendar-ffb7ed8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FrK12pNmtM01wZlwpPrIX

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-splits-calendar-ffb7ed8f
```

Example prompt: Show me all upcoming forward stock splits from 2024-01-01 to 2024-12-31, sorted newest first, up to 100 results.

## When to prefer this

Use this endpoint when you need structured, filterable stock split calendar data — especially for filtering by split type (forward vs reverse) and date range. Prefer over general market data APIs when corporate action data with exact ratios and execution dates is required for portfolio adjustment, options pricing, or historical analysis.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) returns a validation error
- limit exceeding 1000 returns a schema validation error
- Payment not provided or insufficient USDC results in 402 Payment Required
- No splits found in the requested range returns count: 0 with empty splits array

## How this service works

Market-wide split calendar across all US tickers (no ticker needed). Each row has the ticker, execution date, direction (`forward`/`reverse`), split_from/split_to, numeric `ratio`, and a human `ratio_text` like `10:1` or `1:8`. Future-dated announced splits sort first. Filter `?type=forward|reverse|all`, `?from=`/`?to=` date window, `?order=`, `?limit=`. From x402stock

## Output

A JSON object containing a list of stock splits with fields: ticker symbol, execution date, split type (forward/reverse/even), split_from shares, split_to shares, numeric ratio, and human-readable ratio_text (e.g. '10:1'). Also includes the total count and data source timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "to": "2024-12-31",
   "from": "2024-01-01",
   "type": "forward",
   "limit": 50,
   "order": "desc"
  }
 }
}
```

## 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": [
      "type",
      "order",
      "limit"
     ],
     "properties": {
      "to": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "from": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "type": {
       "enum": [
        "forward",
        "reverse",
        "all"
       ],
       "type": "string",
       "default": "all"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 1000,
       "exclusiveMinimum": 0
      },
      "order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "desc"
      }
     },
     "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": [
      "source",
      "as_of",
      "count",
      "splits"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "splits": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "execution_date",
         "type",
         "split_from",
         "split_to",
         "ratio",
         "ratio_text"
        ],
        "properties": {
         "type": {
          "enum": [
           "forward",
           "reverse",
           "even"
          ],
          "type": "string"
         },
         "ratio": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
         "ticker": {
          "type": "string"
         },
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-05T18:00:00.000Z",
  "count": 2,
  "source": "x402stock",
  "splits": [
   {
    "type": "forward",
    "ratio": 10,
    "ticker": "NVDA",
    "split_to": 10,
    "ratio_text": "10:1",
    "split_from": 1,
    "execution_date": "2024-06-10"
   },
   {
    "type": "reverse",
    "ratio": 0.125,
    "ticker": "GE",
    "split_to": 1,
    "ratio_text": "1:8",
    "split_from": 8,
    "execution_date": "2021-08-02"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-splits-calendar-ffb7ed8f/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)