Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Trading Halts and LULD Pause Data API

Every halt, volatility pause, resume and short sale restriction for US stocks, with the reason code and exact time, so you know when a stock can't trade and why.

Coverage

What you get

Item Detail
Product code STK-TRADING-STATUS
Coverage US-listed stocks and ETFs
Granularity One record per status event
History Full history from Starter (planned)
Delivery REST and webhook on Starter; WebSocket push from Pro
Update speed As events happen; real-time push on Pro

A halted stock can't fill your order, and your stop won't save you on the reopen. Day traders want to know the moment it happens. Backtesters need the other side of it: a strategy that "sold" during a five-minute LULD pause never actually got out. This product records each event as its own row, so you can do both.

Schema

Schema

Field Type Required Description
symbol string yes Our ticker
timestamp string yes Event time, ISO 8601 UTC
event string yes halt, resume, pause, ssr_on, ssr_off, quote_resume
reason_code string optional Exchange code, e.g. T1 (news pending), LUDP (volatility pause)
reason string optional Plain-text reason
is_trading boolean yes Trading allowed after this event
is_quoting boolean optional Quoting allowed
is_short_sale_restricted boolean yes SSR in effect
exchange string yes Venue that issued it

Example record:

{
  "symbol": "SMCI",
  "timestamp": "2026-11-18T15:12:05.000Z",
  "event": "pause",
  "reason_code": "LUDP",
  "reason": "Volatility trading pause",
  "is_trading": false,
  "is_quoting": false,
  "is_short_sale_restricted": true,
  "exchange": "XNAS"
}

The example shows a Limit Up-Limit Down pause (LUDP). Trading and quoting stop, so is_trading and is_quoting are false. A later resume event for the same symbol flips them back. The SSR flag is separate: once triggered it typically stays on for the rest of the day and the next one, so it gets its own ssr_on and ssr_off events.

Sample data

Sample data

A free halts sample isn't published yet. Status events come with the exchange feed we're still licensing. Ask and we'll send a sample file once we can.

Use cases

Use cases

Halt alerts. Subscribe to event = halt and pause for your watchlist. The reason_code tells you if it's T1 (news pending, could be a long one) or LUDP (volatility pause, usually minutes).

Honest backtests. Join halt windows to your intraday bars and block any simulated fill between a halt and the next resume. Momentum and small-cap strategies get noticeably worse once you do this, which is the point.

SSR-aware short selling. is_short_sale_restricted tells you when shorts can only go in above the national best bid. If your strategy shorts weakness into the close, flag those days and see how much edge depended on hitting the bid.

Volatility screens. Count LULD pauses per symbol per day. Names with repeated pauses are where the volatility traders are, and also where spreads blow out.

Code

Code examples

Example: all halts and pauses on one day.

curl "https://api.marketdata.co/v1/stocks/trading-status?date=2026-11-18&event=halt,pause" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: count LULD pauses per symbol over a month.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/stocks/trading-status",
    params={"start": "2026-10-01", "end": "2026-10-31", "event": "pause"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
events = pd.DataFrame(resp.json()["results"])
events["timestamp"] = pd.to_datetime(events["timestamp"])

luld = events[events["reason_code"] == "LUDP"]
print(luld.groupby("symbol")["timestamp"].count().sort_values(ascending=False).head(20))

Pricing

Pricing

Plan Trading halts and status
Starter, $29/mo Halt, pause, resume and SSR events by REST and webhook, full history
Pro, $79/mo Adds real-time WebSocket push
Business, $249/mo Commercial internal use

There's no separate dataset; the full history comes with the API on Starter. For context, the providers we studied bundle halt data into plans costing $99 to $199 a month, with a median of about $150, based on 4 prices.

Side by side

How we compare

7 of the 50 providers we studied sell halt and status data, mostly inside larger plans. We plan to put it on the $29 Starter plan with full history, show the price here, and use the same symbol and UTC timestamp as our bars and trades, so joining halt windows to price data is a merge on two columns.

FAQ

Frequently asked questions

How far back does halt history go?

Starter is planned with the full history of our source. We'll publish the exact start date once the feed is licensed, rather than guess at it now.

What do the reason codes mean?

reason_code is the code the exchange published, for example T1 for news pending or LUDP for a volatility pause. The reason field gives the plain-text version so you don't need a lookup table.

What time zone are events in?

UTC, ISO 8601. A pause at 10:12 New York time in November shows as 15:12:05Z. See our timestamps guide.

Is the data real-time or delayed?

Starter delivers events by REST and webhook as they're published; Pro adds a real-time WebSocket push for the lowest delay. Exact delays will be confirmed with the feed licence.

Does it include the short sale restriction list?

Yes. ssr_on and ssr_off events plus the is_short_sale_restricted flag tell you which stocks are under SSR on any day.

What formats are available?

JSON from the API and webhooks. Export to CSV from pandas as shown above if you need a file.

Keep reading