Skip to content
Clear Street Clear Street
Start Trading
API Reference
V1
Instrument Data

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.

ParametersExpand Collapse
query V1InstrumentDataGetAllInstrumentEventsParams
EventTypes param.Field[[]AllEventsEventType]Optional

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]Optional

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

InstrumentIDs param.Field[[]string]Optional

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

ToDate param.Field[string]Optional

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

ReturnsExpand Collapse
type V1InstrumentDataGetAllInstrumentEventsResponse struct{…}

All-events payload grouped by date.

Events grouped by date in descending order.

Date Time

Event date.

formatdate

Flat event envelopes for this date.

Symbol string

Symbol associated with the event.

Event type discriminator.

One of the following:
const AllEventsEventTypeEarnings AllEventsEventType = "EARNINGS"
const AllEventsEventTypeDividend AllEventsEventType = "DIVIDEND"
const AllEventsEventTypeStockSplit AllEventsEventType = "STOCK_SPLIT"
const AllEventsEventTypeIpo AllEventsEventType = "IPO"
DividendEventData InstrumentDividendEventOptional

Dividend payload when type is DIVIDEND. When a null/undefined value is observed, it indicates it does not apply.

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.

formatdate
DeclarationDate TimeOptional

The declaration date of the dividend When a null/undefined value is observed, it indicates that there is no available data.

formatdate
DividendAmount stringOptional

The dividend amount per share. When a null/undefined value is observed, it indicates that there is no available data.

DividendYield stringOptional

The dividend yield as a percentage of the stock price. When a null/undefined value is observed, it indicates that there is no available data.

Frequency stringOptional

The frequency of the dividend payments (e.g., “Quarterly”, “Annual”). When a null/undefined value is observed, it indicates that there is no available data.

PaymentDate TimeOptional

The payment date is the date on which a declared stock dividend is scheduled to be paid. When a null/undefined value is observed, it indicates that there is no available data.

formatdate
RecordDate TimeOptional

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. When a null/undefined value is observed, it indicates that there is no available data.

formatdate
EarningsEventData InstrumentEarningsOptional

Earnings payload when type is EARNINGS. When a null/undefined value is observed, it indicates it does not apply.

Date Time

The date when the earnings report was published

formatdate
EpsActual stringOptional

The actual earnings per share (EPS) for the period When a null/undefined value is observed, it indicates that there is no available data.

EpsEstimate stringOptional

The estimated earnings per share (EPS) for the period When a null/undefined value is observed, it indicates that there is no available data.

EpsSurprisePercent stringOptional

The percentage difference between actual and estimated EPS When a null/undefined value is observed, it indicates that there is no available data.

RevenueActual stringOptional

The actual total revenue for the period When a null/undefined value is observed, it indicates that there is no available data.

RevenueEstimate stringOptional

The estimated total revenue for the period When a null/undefined value is observed, it indicates that there is no available data.

RevenueSurprisePercent stringOptional

The percentage difference between actual and estimated revenue When a null/undefined value is observed, it indicates that there is no available data.

InstrumentID stringOptional

Instrument identifier, when available. When a null/undefined value is observed, it indicates that there is no available data.

formatuuid
IpoEventData InstrumentEventIpoItemOptional

IPO payload when type is IPO. When a null/undefined value is observed, it indicates it does not apply.

Actions stringOptional

IPO action. When a null/undefined value is observed, it indicates that there is no available data.

AnnouncedAt TimeOptional

IPO announced timestamp. When a null/undefined value is observed, it indicates that there is no available data.

formatdate-time
Company stringOptional

IPO company name. When a null/undefined value is observed, it indicates that there is no available data.

Exchange stringOptional

IPO exchange. When a null/undefined value is observed, it indicates that there is no available data.

MarketCap stringOptional

IPO market cap. When a null/undefined value is observed, it indicates that there is no available data.

PriceRange stringOptional

IPO price range. When a null/undefined value is observed, it indicates that there is no available data.

Shares stringOptional

IPO shares offered. When a null/undefined value is observed, it indicates that there is no available data.

Name stringOptional

Instrument name associated with the event, when available. When a null/undefined value is observed, it indicates that there is no available data.

ReportingCurrency stringOptional

The currency used for reporting financial data. When a null/undefined value is observed, it indicates that there is no available data.

StockSplitEventData InstrumentSplitEventOptional

Stock split payload when type is STOCK_SPLIT. When a null/undefined value is observed, it indicates it does not apply.

Date Time

The date of the stock split

formatdate
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”)

Get All Instrument Events

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)
}

{
  "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"
  }
}
{
  "error": {
    "code": 400,
    "message": "Failed to deserialize query string. Error: premature end of input"
  },
  "metadata": {
    "request_id": "e0a9bd3a-8510-41a7-8144-c51a27787b9c"
  }
}
Returns Examples
{
  "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"
  }
}
{
  "error": {
    "code": 400,
    "message": "Failed to deserialize query string. Error: premature end of input"
  },
  "metadata": {
    "request_id": "e0a9bd3a-8510-41a7-8144-c51a27787b9c"
  }
}