Trading Halts API.
LULD halts, T1/T2 regulatory halts, circuit breakers, and exchange-initiated suspensions — as typed events with halt code, reason, and resume timestamps. Know the moment a name goes dark.
Every event_type in market_structure.
Each type emits the same envelope with a family-specific payload. Subscribe to the whole family or filter to specific types.
trading_halt_initiatedExchange or regulator halts trading on a symbol.
trading_halt_resumedTrading resumes after a halt period.
luld_pauseLimit Up-Limit Down market-wide or single-stock pause triggered.
circuit_breaker_triggeredMarket-wide circuit breaker activated (Level 1/2/3).
ipo_halt_releasedIPO or direct listing halt released for initial trading.
One real event. Full JSON payload.
This is the exact shape you'd receive via GET /v1/events or via a signed webhook delivery.
Request
// Query all market_structure events in the last 14 days GET /v1/events?family=market_structure&event_types=trading_halt_initiated&since=2026-04-01 Authorization: Bearer hf_live_...
Response · 200 OK
{
"event_id": "evt_20260413_aldx_market_structure",
"schema_version": "2026-04-20",
"event_type": "trading_halt_initiated",
"assertion_type": "fact",
"status": "official_announced",
"priority": "critical",
"entity": {
"ticker": "ALDX",
"name": "Aldeyra Therapeutics"
},
"lifecycle": {
"detected_at": "2026-04-13T13:42:18Z",
"announced_at": "2026-04-13",
"effective_at": "2026-04-13",
"confirmed_at": "2026-04-13"
},
"source": {
"type": "exchange",
"name": "NYSE · NASDAQ · CTA",
"tier": "tier_1"
},
"summary": {
"one_line": "NASDAQ initiated a T1 trading halt on ALDX pending a material news announcement."
},
"payload": {
"halt_code": "T1",
"halt_reason": "Pending news",
"exchange": "NASDAQ",
"halted_at": "2026-04-13T14:32:18Z",
"resumed_at": null,
"duration_seconds": null
},
"confidence": {
"overall": 0.98,
"identity": 0.99,
"event_classification": 0.98
}
}Recent market_structure events.
Pulled live from the public delayed feed. Click through to the full tape for payloads, lifecycle, and source links.
Ranked by authority, merged by entity.
Every event carries a source object. When the same event is confirmed by multiple sources, they merge into one canonical event with an evidence array.
NYSE · NASDAQ · CTA
Direct from exchange halt feeds · sub-second latency
SEC trading suspensions
Administrative proceedings and 10-day suspensions
CQS / UTP SIP
Consolidated tape halt/resume messages
Company halt requests
Issuer-requested halts pending material news
OPRA · options exchanges
Correlated options halt data
Reuters · Bloomberg wire
Contextual reporting on halt reasons
Family-specific fields inside payload.
All events share the same envelope (event_id, entity, lifecycle, sources, assertion_type, confidence). The payloadis what's specific to this family.
| Field | Type | Description | Example |
|---|---|---|---|
| payload.halt_code | string | Exchange halt reason code (T1, T2, LUDP, M, etc.). | "T1" |
| payload.halt_reason | string | Human-readable halt reason. | "Pending news" |
| payload.exchange | string | Primary listing exchange. | "NASDAQ" |
| payload.halted_at | datetime | Exact halt timestamp. | "2026-04-13T14:32:18Z" |
| payload.resumed_at | datetime? | Resume timestamp, null if still halted. | null |
| payload.duration_seconds | integer? | Halt duration in seconds, if resumed. | 1847 |
Start tracking market_structure events.
Developer tier from $99/mo. Real-time, webhooks, and 250-entity watchlists at $299 Pro.