HomeChatAlertsCalendarScreenerWatchlistsFiles
DocsSettings
Sign upJoinLog in

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

WebSocket

Live Quotes (Per Second)Live Quotes (Per Minute)Live NewsLive SEC FilingsTrading Halts

Trading Halts

WSwss://socket.vantafin.com/v1/stocks
View as markdown

Subscribe to NASDAQ trading halt and resumption events. Channel H.{ticker} targets one ticker; H.* receives every halt market-wide. Messages include halt status, reason codes, human-readable reasons and expected resumption times in US/Eastern. Events are pushed when halt status changes - use for risk controls, trading halts boards and compliance monitoring.

Use cases

  • Real-time halt monitors and trading risk dashboards
  • Blocking or flagging orders on halted tickers
  • Market-wide halt feeds for ops and compliance teams
  • Event-driven alerts when a watched ticker is halted or resumes

Subscribe

Send a subscribe message after connecting. Use H.{ticker} (e.g. H.AAPL) for a single symbol or H.* for every symbol.

{
  "action": "subscribe",
  "params": "H.AAPL"
}

Message fields

FieldTypeDescription
typestringAlways 'halt'.
tickerstringHalted/resumed ticker.
haltedbooleantrue when currently halted, false on resume.
reason_codestringNASDAQ halt reason code, e.g. T1, LUDP.
reasonstringHuman-readable halt reason.
halt_datestringHalt date (MM/DD/YYYY, US/Eastern).
halt_timestringHalt time (HH:MM:SS, US/Eastern).
resumption_datestringExpected resumption date, if known.
resumption_quote_timestringExpected quote resumption time.
resumption_trade_timestringExpected trade resumption time.
pause_threshold_pricestringLULD pause threshold price, if applicable.
from vantafin import WebSocketClient

ws = WebSocketClient("vf-live-your_api_key")
ws.connect()
ws.subscribe(["H.AAPL"])

for message in ws:
    print(message)
{
  "type": "halt",
  "ticker": "AAPL",
  "halted": true,
  "reason_code": "T1",
  "reason": "Halt - News Pending",
  "halt_date": "06/16/2026",
  "halt_time": "09:45:00",
  "resumption_date": "06/16/2026",
  "resumption_quote_time": "09:55:00",
  "resumption_trade_time": "10:00:00"
}
Live SEC Filings