Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Instrument Data

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.

ParametersExpand Collapse
event_types: Optional[List[AllEventsEventType]]

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

One of the following:
"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).

ReturnsExpand Collapse
class InstrumentDataGetAllInstrumentEventsResponse: …

All-events payload grouped by date.

event_dates: List[InstrumentEventsByDate]

Events grouped by date in descending order.

date: date

Event date.

formatdate

Flat event envelopes for this date.

symbol: str

Symbol associated with the event.

Event type discriminator.

One of the following:
"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.

formatdate
declaration_date: Optional[date]

The declaration date of the dividend

formatdate
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.

formatdate
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.

formatdate
earnings_event_data: Optional[InstrumentEarnings]

Earnings payload when type is EARNINGS.

date: date

The date when the earnings report was published

formatdate
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.

formatuuid
ipo_event_data: Optional[InstrumentEventIpoItem]

IPO payload when type is IPO.

actions: Optional[str]

IPO action.

announced_at: Optional[datetime]

IPO announced timestamp.

formatdate-time
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

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

Get All Instrument Events

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_all_instrument_events()
print(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"
  }
}