# GET /v2/tickers/{ticker}/events

**Ticker event log**

Returns splits, dividends, and analyst rating changes for the ticker, newest-first, in a unified envelope. Each event has a `ts`, a `kind`, and a `payload` whose shape depends on the kind.

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 60/min · Pro 2,000/min · Scale 10,000/min.
- **History.** Hobby 1y · Pro 5y · Scale all-time.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `ticker` | path | string | yes | Ticker symbol. Example: `AAPL`. |
| `from` | query | string | no | Earliest event timestamp (inclusive). YYYY-MM-DD or ISO. Defaults to your plan's history window. |
| `to` | query | string | no | Latest event timestamp (inclusive). YYYY-MM-DD or ISO. Defaults to "now". |
| `kind` | query | string | no | Filter by event kind. Enum: `split`, `dividend`, `rating_change`. |
| `limit` | query | integer | no | Page size. Max 1000. Default: `100`. |
| `cursor` | query | string | no | Opaque cursor from the previous response. |

## Status codes

- **200** — Page of events with `as_of`, `count`, `next_cursor`, and `events`.
- **400** — Invalid ticker, invalid date format, invalid kind, or beyond your plan's history window.
- **404** — Ticker not tracked.

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "ticker": "AAPL",
  "filter": { "from": "2025-11-14", "to": null, "kind": null },
  "count": 2,
  "next_cursor": "eyJiZWZvcmVfdHMiOiIyMDI2LTA1LTA4VDAwOjAwOjAwLjAwMFoifQ",
  "events": [
    {
      "ts": "2026-05-11T00:00:00.000Z",
      "kind": "dividend",
      "payload": { "amount": 0.27, "ex_date": "2026-05-11", "pay_date": "2026-05-14", "record_date": "2026-05-11", "declared_date": "2026-04-30", "frequency": 4 }
    },
    {
      "ts": "2026-05-08T00:00:00.000Z",
      "kind": "rating_change",
      "payload": { "firm": "Wedbush", "analyst": "Dan Ives", "currency": "USD", "pt_prior": 285, "pt_current": 315, "action": "Maintains", "rating": "Outperform" }
    }
  ]
}
```

## Examples

### AAPL's recent events

Request:

```shell
curl "https://api.tickerbot.io/v2/tickers/AAPL/events?limit=2" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "ticker": "AAPL",
  "filter": { "from": "2025-11-14", "to": null, "kind": null },
  "count": 2,
  "next_cursor": "eyJiZWZvcmVfdHMiOiIyMDI2LTA1LTA4VDAwOjAwOjAwLjAwMFoifQ",
  "events": [
    {
      "ts": "2026-05-11T00:00:00.000Z",
      "kind": "dividend",
      "payload": { "amount": 0.27, "ex_date": "2026-05-11", "pay_date": "2026-05-14", "record_date": "2026-05-11", "declared_date": "2026-04-30", "frequency": 4 }
    },
    {
      "ts": "2026-05-08T00:00:00.000Z",
      "kind": "rating_change",
      "payload": { "firm": "Wedbush", "analyst": "Dan Ives", "currency": "USD", "pt_prior": 285, "pt_current": 315, "action": "Maintains", "rating": "Outperform" }
    }
  ]
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/api/endpoints/tickers/events