## Get All Instrument Events

`v1.instrument_data.get_all_instrument_events(InstrumentDataGetAllInstrumentEventsParams**kwargs)  -> InstrumentDataGetAllInstrumentEventsResponse`

**get** `/v1/instruments/events`

List instrument events across all securities.

Retrieves all instrument events grouped by date.

### Parameters

- `event_types: Optional[List[AllEventsEventType]]`

  Filter by event type(s). Comma-delimited list. Example: `event_types=EARNINGS,IPO`.

  - `"EARNINGS"`

  - `"DIVIDEND"`

  - `"STOCK_SPLIT"`

  - `"IPO"`

- `from_date: Optional[str]`

  The start date for the query range, inclusive (YYYY-MM-DD).

- `instrument_ids: Optional[Sequence[str]]`

  Filter by OEMS instrument ID(s). Comma-delimited list of UUIDs. Example: `instrument_ids=550e8400-e29b-41d4-a716-446655440000`.

- `to_date: Optional[str]`

  The end date for the query range, inclusive (YYYY-MM-DD).

### Returns

- `class InstrumentDataGetAllInstrumentEventsResponse: …`

  - `data: InstrumentAllEventsData`

    All-events payload grouped by date.

    - `event_dates: List[InstrumentEventsByDate]`

      Events grouped by date in descending order.

      - `date: date`

        Event date.

      - `events: List[InstrumentEventEnvelope]`

        Flat event envelopes for this date.

        - `symbol: str`

          Symbol associated with the event.

        - `type: AllEventsEventType`

          Event type discriminator.

          - `"EARNINGS"`

          - `"DIVIDEND"`

          - `"STOCK_SPLIT"`

          - `"IPO"`

        - `dividend_event_data: Optional[InstrumentDividendEvent]`

          Dividend payload when type is DIVIDEND.

          - `adjusted_dividend_amount: str`

            The adjusted dividend amount accounting for any splits.

          - `ex_date: date`

            The day the stock starts trading without the right to receive that dividend.

          - `declaration_date: Optional[date]`

            The declaration date of the dividend

          - `dividend_amount: Optional[str]`

            The dividend amount per share.

          - `dividend_yield: Optional[str]`

            The dividend yield as a percentage of the stock price.

          - `frequency: Optional[str]`

            The frequency of the dividend payments (e.g., "Quarterly", "Annual").

          - `payment_date: Optional[date]`

            The payment date is the date on which a declared stock dividend is scheduled to be paid.

          - `record_date: Optional[date]`

            The record date, set by a company's board of directors, is when a
            company compiles a list of shareholders of the stock for which it has declared a dividend.

        - `earnings_event_data: Optional[InstrumentEarnings]`

          Earnings payload when type is EARNINGS.

          - `date: date`

            The date when the earnings report was published

          - `eps_actual: Optional[str]`

            The actual earnings per share (EPS) for the period

          - `eps_estimate: Optional[str]`

            The estimated earnings per share (EPS) for the period

          - `eps_surprise_percent: Optional[str]`

            The percentage difference between actual and estimated EPS

          - `revenue_actual: Optional[str]`

            The actual total revenue for the period

          - `revenue_estimate: Optional[str]`

            The estimated total revenue for the period

          - `revenue_surprise_percent: Optional[str]`

            The percentage difference between actual and estimated revenue

        - `instrument_id: Optional[str]`

          OEMS instrument identifier, when the instrument is found in the instrument cache.

        - `ipo_event_data: Optional[InstrumentEventIpoItem]`

          IPO payload when type is IPO.

          - `actions: Optional[str]`

            IPO action.

          - `announced_at: Optional[datetime]`

            IPO announced timestamp.

          - `company: Optional[str]`

            IPO company name.

          - `exchange: Optional[str]`

            IPO exchange.

          - `market_cap: Optional[str]`

            IPO market cap.

          - `price_range: Optional[str]`

            IPO price range.

          - `shares: Optional[str]`

            IPO shares offered.

        - `name: Optional[str]`

          Instrument name associated with the event, when available.

        - `reporting_currency: Optional[str]`

          The currency used for reporting financial data.

        - `stock_split_event_data: Optional[InstrumentSplitEvent]`

          Stock split payload when type is STOCK_SPLIT.

          - `date: date`

            The date of the stock split

          - `denominator: str`

            The denominator of the split ratio

          - `numerator: str`

            The numerator of the split ratio

          - `split_type: str`

            The type of stock split (e.g., "stock-split", "stock-dividend", "bonus-issue")

### Example

```python
from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_all_instrument_events()
print(response)
```

#### Response

```json
{
  "data": {
    "event_dates": [
      {
        "date": "2026-04-23",
        "events": [
          {
            "dividend_event_data": {
              "adjusted_dividend_amount": "0.5236",
              "declaration_date": "2026-04-22",
              "dividend_amount": "0.5236",
              "dividend_yield": "43.82881469863321",
              "ex_date": "2026-04-23",
              "frequency": "Weekly",
              "payment_date": "2026-04-24",
              "record_date": "2026-04-23"
            },
            "instrument_id": "2281b543-7136-4008-aa0a-a402bf9d9f90",
            "name": "YieldMax ABNB Option Income Strategy ETF",
            "reporting_currency": "USD",
            "symbol": "ABNY",
            "type": "DIVIDEND"
          },
          {
            "dividend_event_data": {
              "adjusted_dividend_amount": "0.1432",
              "declaration_date": "2026-04-22",
              "dividend_amount": "0.1432",
              "dividend_yield": "181.7918287937743",
              "ex_date": "2026-04-23",
              "frequency": "Weekly",
              "payment_date": "2026-04-24",
              "record_date": "2026-04-23"
            },
            "instrument_id": "4b33fa52-8ab6-43f5-a8df-042e0c63d20e",
            "name": "YieldMax AI Option Income Strategy ETF",
            "reporting_currency": "USD",
            "symbol": "AIYY",
            "type": "DIVIDEND"
          }
        ]
      }
    ]
  },
  "metadata": {
    "request_id": "5efbf08a-9067-4491-9f29-cf0b233507ef"
  }
}
```