## Get All Instrument Events

`client.V1.InstrumentData.GetAllInstrumentEvents(ctx, query) (*V1InstrumentDataGetAllInstrumentEventsResponse, error)`

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

List instrument events across all securities.

Retrieves all instrument events grouped by date.

### Parameters

- `query V1InstrumentDataGetAllInstrumentEventsParams`

  - `EventTypes param.Field[[]AllEventsEventType]`

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

    - `const AllEventsEventTypeEarnings AllEventsEventType = "EARNINGS"`

    - `const AllEventsEventTypeDividend AllEventsEventType = "DIVIDEND"`

    - `const AllEventsEventTypeStockSplit AllEventsEventType = "STOCK_SPLIT"`

    - `const AllEventsEventTypeIpo AllEventsEventType = "IPO"`

  - `FromDate param.Field[string]`

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

  - `InstrumentIDs param.Field[[]string]`

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

  - `ToDate param.Field[string]`

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

### Returns

- `type V1InstrumentDataGetAllInstrumentEventsResponse struct{…}`

  - `Data InstrumentAllEventsData`

    All-events payload grouped by date.

    - `EventDates []InstrumentEventsByDate`

      Events grouped by date in descending order.

      - `Date Time`

        Event date.

      - `Events []InstrumentEventEnvelope`

        Flat event envelopes for this date.

        - `Symbol string`

          Symbol associated with the event.

        - `Type AllEventsEventType`

          Event type discriminator.

          - `const AllEventsEventTypeEarnings AllEventsEventType = "EARNINGS"`

          - `const AllEventsEventTypeDividend AllEventsEventType = "DIVIDEND"`

          - `const AllEventsEventTypeStockSplit AllEventsEventType = "STOCK_SPLIT"`

          - `const AllEventsEventTypeIpo AllEventsEventType = "IPO"`

        - `DividendEventData InstrumentDividendEvent`

          Dividend payload when type is DIVIDEND.

          - `AdjustedDividendAmount string`

            The adjusted dividend amount accounting for any splits.

          - `ExDate Time`

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

          - `DeclarationDate Time`

            The declaration date of the dividend

          - `DividendAmount string`

            The dividend amount per share.

          - `DividendYield string`

            The dividend yield as a percentage of the stock price.

          - `Frequency string`

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

          - `PaymentDate Time`

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

          - `RecordDate Time`

            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.

        - `EarningsEventData InstrumentEarnings`

          Earnings payload when type is EARNINGS.

          - `Date Time`

            The date when the earnings report was published

          - `EpsActual string`

            The actual earnings per share (EPS) for the period

          - `EpsEstimate string`

            The estimated earnings per share (EPS) for the period

          - `EpsSurprisePercent string`

            The percentage difference between actual and estimated EPS

          - `RevenueActual string`

            The actual total revenue for the period

          - `RevenueEstimate string`

            The estimated total revenue for the period

          - `RevenueSurprisePercent string`

            The percentage difference between actual and estimated revenue

        - `InstrumentID string`

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

        - `IpoEventData InstrumentEventIpoItem`

          IPO payload when type is IPO.

          - `Actions string`

            IPO action.

          - `AnnouncedAt Time`

            IPO announced timestamp.

          - `Company string`

            IPO company name.

          - `Exchange string`

            IPO exchange.

          - `MarketCap string`

            IPO market cap.

          - `PriceRange string`

            IPO price range.

          - `Shares string`

            IPO shares offered.

        - `Name string`

          Instrument name associated with the event, when available.

        - `ReportingCurrency string`

          The currency used for reporting financial data.

        - `StockSplitEventData InstrumentSplitEvent`

          Stock split payload when type is STOCK_SPLIT.

          - `Date Time`

            The date of the stock split

          - `Denominator string`

            The denominator of the split ratio

          - `Numerator string`

            The numerator of the split ratio

          - `SplitType string`

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

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.InstrumentData.GetAllInstrumentEvents(context.TODO(), clearstreet.V1InstrumentDataGetAllInstrumentEventsParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", 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"
  }
}
```