# x402stock.xyz Stock Events by Ticker

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

Retrieve the historical corporate events (ticker changes, name changes, delistings, etc.) for a specific stock ticker symbol.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/events/AAPL
- Price: $0.01/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-252632fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IcsnMmPkXZkTzsWHxIngf

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-252632fb
```

Example prompt: Can you pull up the full corporate events history for AAPL — things like ticker changes, name changes, or delistings — along with the composite FIGI and CIK?

## When to prefer this

Use this endpoint when you need the historical corporate event timeline for a specific ticker — including name changes, ticker symbol changes, delistings, or relistings. Prefer this over a general ticker search endpoint when you already know the symbol and want the event history rather than metadata or price data.

## Known failure modes

- Unknown or invalid ticker symbol returns empty events array or 404
- Payment not completed (x402 flow not fulfilled) results in 402 Payment Required
- Ticker exists but has no recorded events returns empty events array
- Rate limiting or service unavailability returns 5xx error

## How this service works

Timeline of corporate events for a ticker, such as ticker symbol changes, with the company name, CIK, and composite FIGI. 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 an object containing the ticker symbol queried, a data block with company name, composite FIGI, CIK, and an array of events (each with type, date, and ticker at the time of the event), plus the source ('massive') and the as-of date.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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",
     "properties": {}
    }
   },
   "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": [
        "name",
        "composite_figi",
        "cik",
        "events"
       ],
       "properties": {
        "cik": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "name": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "events": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "type",
           "date",
           "ticker"
          ],
          "properties": {
           "date": {
            "type": "string"
           },
           "type": {
            "type": "string"
           },
           "ticker": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           }
          },
          "additionalProperties": false
         }
        },
        "composite_figi": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "as_of": {
       "type": "string"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "ticker": {
       "type": "string"
      },
      "feedback": {
       "type": "object",
       "required": [
        "endpoint",
        "method",
        "free",
   
… (truncated)
```

## More

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