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

**Ticker event log**

Returns dividends, splits, and insider transactions 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. (Analyst rating changes are a separate feed: `/v2/analyst/events`.)

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 600/min · Pro 2,000/min · Scale 10,000/min.
- **History.** All-time on every paid plan.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `ticker` | path | string | yes | Ticker symbol. Example: `AAPL`. |
| `kind` | query | string | no | Filter by event kind. Omit for all three merged into one timeline. Enum: `dividend`, `split`, `insider`. |
| `before` | query | string | no | Return events strictly before this date (YYYY-MM-DD). Back-paging cursor; pass the previous response's `next_cursor`. |
| `limit` | query | integer | no | Page size. Max 1000. Default: `100`. |

## Status codes

- **200** — Page of events with `as_of`, `ticker`, `kind`, `count`, `next_cursor`, and `events`.
- **400** — Invalid ticker or invalid kind.

## Sample response

```json
{
  "as_of": "2026-06-18T17:39:24.953Z",
  "ticker": "NVDA",
  "kind": "all",
  "count": 2,
  "next_cursor": "2026-06-03",
  "events": [
    {
      "ts": "2026-06-08T00:00:00.000Z",
      "kind": "insider",
      "payload": { "executive": "GAWEL, SCOTT", "title": "Principal Accounting Officer", "action": "A", "shares": 45643, "price": 0, "value": 0 }
    },
    {
      "ts": "2026-06-04T00:00:00.000Z",
      "kind": "dividend",
      "payload": { "amount": 0.01, "ex_date": "2026-06-04", "pay_date": "2026-06-26", "record_date": "2026-06-05", "declared_date": "2026-05-28", "dividend_type": "CD", "frequency": 4 }
    }
  ]
}
```

## Examples

### NVDA's recent events (all kinds)

Request:

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

Response (`200`):

```json
{
  "as_of": "2026-06-18T17:39:24.953Z",
  "ticker": "NVDA",
  "kind": "all",
  "count": 2,
  "next_cursor": "2026-06-03",
  "events": [
    {
      "ts": "2026-06-08T00:00:00.000Z",
      "kind": "insider",
      "payload": { "executive": "GAWEL, SCOTT", "title": "Principal Accounting Officer", "action": "A", "shares": 45643, "price": 0, "value": 0 }
    },
    {
      "ts": "2026-06-04T00:00:00.000Z",
      "kind": "dividend",
      "payload": { "amount": 0.01, "ex_date": "2026-06-04", "pay_date": "2026-06-26", "record_date": "2026-06-05", "declared_date": "2026-05-28", "dividend_type": "CD", "frequency": 4 }
    }
  ]
}
```

---

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