Instrument Data
Get All Instrument Events
List instrument events across all securities.
Retrieves all instrument events grouped by date.
get/v1/instruments/events
Query parameters
event_typesAllEventsEventType[]
Filter by event type(s). Comma-delimited list. Example: event_types=EARNINGS,IPO.
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.
from_datestring
The start date for the query range, inclusive (YYYY-MM-DD).
to_datestring
The end date for the query range, inclusive (YYYY-MM-DD).
Response
Instrument events grouped by date
Example response
{
"error": {
"code": 400,
"message": "Order quantity must be greater than zero"
},
"data": {
"event_dates": [
{
"events": [
{
"dividend_event_data": {
"adjusted_dividend_amount": "0.88",
"declaration_date": "2025-07-25",
"dividend_amount": "0.88",
"dividend_yield": "1.25",
"ex_date": "2025-08-15",
"frequency": "Quarterly",
"payment_date": "2025-08-20",
"record_date": "2025-08-01"
},
"earnings_event_data": {
"date": "2025-07-25",
"eps_actual": "1.35",
"eps_estimate": "1.30",
"eps_surprise_percent": "3.8",
"report_time": "BMO",
"revenue_actual": "391035000000",
"revenue_estimate": "391025000000",
"revenue_surprise_percent": "0.05"
},
"stock_split_event_data": {
"date": "2025-08-15",
"denominator": "4",
"numerator": "1",
"split_type": "stock-split"
}
}
]
}
]
}
}