Skip to main content
GET
Get price events for a stock

Path Parameters

symbol
string
required

Query Parameters

days
integer
default:30

Number of days to look back

Required range: 1 <= x <= 90
event_types
string | null

Comma-separated event types to filter (e.g., gap_up,gap_down,golden_cross)

min_severity
string | null

Minimum severity: low, medium, high, critical

Response

List of price events

event_id
string
required

Unique ID: {symbol}{type}{YYYYMMDD_HHMMSS}_{hash6}

event_type
string
required

Event type (gap_up, gap_down, breakout_52w_high, golden_cross, etc.)

event_date
string<date-time>
required

Bar timestamp when event was detected

severity
string
required

Event severity: low, medium, high, critical

magnitude
number | null

Percentage change or ratio for the event

reference_price
number | null

Prior price used for comparison

trigger_price
number | null

Price that triggered the event

level_name
string | null

Level crossed (52w_high, ib_low, vwap, etc.)

level_value
number | null

Value of the level that was crossed

rel_volume
number | null

Relative volume at time of event

atr_ratio
number | null

Move size relative to ATR(14)

details
string | null

Human-readable event description