Get All Instrument Events

$ clst v1:instrument-data get-all-instrument-events

GET/v1/instruments/events

List instrument events across all securities, grouped by date.

Date range defaults (anchored on the current trading day, or the next trading day if today is a weekend or US market holiday):

Unfiltered (no instrument_ids): a single trading day (from_date = to_date = anchor); the requested span is capped at 6 days.
Filtered (with instrument_ids): a 30-day lookback ending on the anchor (from_date = anchor − 30 days, to_date = anchor).

ParametersExpand Collapse

--event-type: optional array of AllEventsEventType

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

--from-date: optional string

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

--instrument-id: optional array of InstrumentIDOrSymbol

Filter by instrument. Comma-separated instrument IDs (UUID) or symbols (equity tickers or OSI option symbols). Example: instrument_ids=550e8400-e29b-41d4-a716-446655440000,AAPL.

--to-date: optional string

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

ReturnsExpand Collapse

V1InstrumentDataGetAllInstrumentEventsResponse: BaseResponse { metadata, error }

data: object { event_dates }

All-events payload grouped by date.

event_dates: array of InstrumentEventsByDate { date, events }

Events grouped by date in descending order.

date: string

Event date.

events: array of InstrumentEventEnvelope { symbol, type, dividend_event_data, 6 more }

Flat event envelopes for this date.

symbol: string

Symbol associated with the event.

type: "EARNINGS" or "DIVIDEND" or "STOCK_SPLIT" or "IPO"

Event type discriminator.

"EARNINGS"

"DIVIDEND"

"STOCK_SPLIT"

"IPO"

dividend_event_data: optional object { adjusted_dividend_amount, ex_date, declaration_date, 5 more }

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

adjusted_dividend_amount: string

The adjusted dividend amount accounting for any splits.

ex_date: string

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

declaration_date: optional string

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

dividend_amount: optional string

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

dividend_yield: optional string

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: optional string

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.

payment_date: optional string

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.

record_date: optional string

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.

earnings_event_data: optional object { date, eps_actual, eps_estimate, 5 more }

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

date: string

The date when the earnings report was published

eps_actual: optional string

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

eps_estimate: optional string

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

eps_surprise_percent: optional string

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

report_time: optional "BMO" or "AMC"

Report timing: before market open or after market close When a null/undefined value is observed, it indicates that there is no available data.

"BMO"

"AMC"

revenue_actual: optional string

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

revenue_estimate: optional string

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

revenue_surprise_percent: optional string

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

instrument_id: optional string

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

ipo_event_data: optional object { actions, announced_at, company, 4 more }

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

actions: optional string

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

announced_at: optional string

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

company: optional string

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

exchange: optional string

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

market_cap: optional string

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

price_range: optional string

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

shares: optional string

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

name: optional string

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

reporting_currency: optional string

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

stock_split_event_data: optional object { date, denominator, numerator, split_type }

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

date: string

The date of the stock split

denominator: string

The denominator of the split ratio

numerator: string

The numerator of the split ratio

split_type: string

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

Get All Instrument Events

clst v1:instrument-data get-all-instrument-events \
  --api-key 'My API Key'

{
  "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"
  }
}