# Corporate Events Timeline by Ticker

> Corporate Events Timeline by Ticker 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-12).

Returns a chronological timeline of corporate events (e.g. ticker symbol changes) for a US-listed stock, along with the company name, CIK, and composite FIGI.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/events/{ticker}
- Price: $0.01/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-corporate-events-timeline-by-ticker-e76b0381
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kpWYT_ngZ6TQxx5reMH3q

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-corporate-events-timeline-by-ticker-e76b0381
```

Example prompt: Can you pull up the full corporate event timeline for META — I want to see if and when they changed their ticker symbol, along with their CIK and FIGI identifiers?

## When to prefer this

Use this endpoint when you need a structured history of corporate events tied to a specific US ticker — especially ticker symbol changes — along with authoritative identifiers like SEC CIK and composite FIGI. Prefer it over general financial data APIs when you need event provenance and identity resolution in a single call without API key setup.

## Known failure modes

- Invalid or unknown ticker returns empty events array or null fields
- Ticker not listed on a US exchange may return no data
- Stale as_of timestamp if upstream data provider has a delay
- Payment failure via x402 if USDC balance is insufficient

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

A JSON object containing the requested ticker, company name, SEC CIK, composite FIGI, and an array of corporate events each with a type, date, and associated ticker symbol, plus a source label and as_of timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "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": [
    "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",
    "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-corporate-events-timeline-by-ticker-e76b0381/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)