Stocks

curl -sS "https://api.tickerlayer.com/stocks/symbols?market=US" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbols": [
    {
      "symbol": "US:AAPL",
      "base_symbol": "AAPL",
      "market": "US",
      "name": "Apple Inc."
    }
  ]
}

curl -sS "https://api.tickerlayer.com/stocks/quote/US:AAPL" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:AAPL",
  "bid": 214.22,
  "ask": 214.25,
  "bid_size": 1200,
  "ask_size": 800,
  "timestamp": 1743512400000
}

curl -sS "https://api.tickerlayer.com/stocks/trade/last/US:AAPL" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:AAPL",
  "price": 214.23,
  "size": 400,
  "timestamp": 1743512400000
}

curl -sS "https://api.tickerlayer.com/stocks/snapshot/US:AAPL" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:AAPL",
  "bid": 214.22,
  "ask": 214.25,
  "bid_size": 1200,
  "ask_size": 800,
  "last_price": 214.23,
  "last_size": 400,
  "last_timestamp": 1743512400000,
  "prev_close": 212.10,
  "change": 2.13,
  "change_percent": 1.004
}

curl -sS "https://api.tickerlayer.com/stocks/agg/US:AAPL/prev" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:AAPL",
  "result": {
    "o": 228.5,
    "h": 230.8,
    "l": 227.9,
    "c": 229.4,
    "v": 52000000,
    "t": 1733011200000
  }
}

curl -sS "https://api.tickerlayer.com/stocks/agg/US:AAPL/1/day/2025-11-01/2025-11-30?sort=desc&limit=2" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:AAPL",
  "results_count": 2,
  "results": [
    { "o": 228.5, "h": 230.8, "l": 227.9, "c": 229.4, "v": 52000000, "t": 1733011200000 },
    { "o": 226.0, "h": 228.9, "l": 225.5, "c": 228.5, "v": 48000000, "t": 1732924800000 }
  ],
  "next_offset": 2
}

wss://stream.tickerlayer.com/?apiKey=<YOUR_API_KEY>

{
  "action": "subscribe",
  "channels": [
    "stocks.quotes",
    "stocks.trades"
  ],
  "symbols": [
    "US:KO",
    "DE:BMW"
  ]
}

{
  "type": "quote",
  "channel": "stocks.quotes",
  "asset": "stocks",
  "symbol": "US:KO",
  "bid": "62.41",
  "ask": "62.43",
  "bid_size": "100",
  "ask_size": "200",
  "ts": 1743512400000
}

{
  "action": "subscribe",
  "channel": "stocks.trades",
  "symbols": ["US:SPCX"],
  "trade_mode": "full_volume"
}

{
  "type": "trade",
  "channel": "stocks.trades",
  "asset": "stocks",
  "symbol": "US:SPCX",
  "price": "111.56",
  "size": "37",
  "ts": 1785342925003,
  "ohlc": 0
}

{
  "action": "subscribe",
  "channels": ["stocks.quotes", "stocks.trades"],
  "symbols": ["US:*"]
}

OHLCV bars over WebSocket

The bars the aggregate routes return, delivered live and included with US stocks access. Subscribe to stocks.agg with US symbols and receive one agg frame per symbol each time a bar settles, on the grid /stocks/agg serves: a bar you receive live is the bar the REST route returns for that window later.

{
  "action": "subscribe",
  "channels": ["stocks.agg"],
  "symbols": ["US:KO", "US:JPM"]
}

{
  "type": "agg",
  "channel": "stocks.agg",
  "asset": "stocks",
  "symbol": "US:KO",
  "interval": "1m",
  "session": "regular",
  "o": 88.48,
  "h": 88.52,
  "l": 88.46,
  "c": 88.5,
  "v": 41230,
  "n": 312,
  "vw": 88.4917,
  "ts": 1789133400000
}

Numbers are numbers: o h l c v the bar, n the trade count, vw the volume-weighted average price, session where the bar starts (pre, regular, post) and ts the bar start in unix ms. A frame arrives a few seconds after its window closes.

Sessions

Intraday bars cover the regular session, 09:30 to 16:00 ET with early closes honored, and the closing auction lands in the daily bar. With "session": "extended", 1m, 5m and 15m bars also arrive from 04:00 to 20:00 ET (17:00 on early closes), tagged pre, regular or post; regular-session bars are identical in both modes, and 1h, 4h and 1d always follow the regular grid.

Closed bars only

No in-progress updates: one frame per symbol, interval and window, however busy the tape. Build a live candle from stocks.trades if you need one.

No snapshot

The first frame arrives within one interval. Backfill with /stocks/agg, which serves the same bars; a bar that settles while you are disconnected is not replayed.

Intervals per symbol

interval takes a string or an array. The latest subscribe for a symbol sets its intervals, and an unsubscribe removes it from all of them.

US equities only

Symbols count toward your distinct-symbol cap like any channel; the market wildcard add-on enables US:* here too.

Overnight session New

An add-on to US Stocks: a derived, aggregated reference quote for the most traded US stocks and ETFs while the listing markets are closed on weeknights (Sunday to Thursday, 20:00 to 04:00 New York). Our aggregation layer blends the sources behind each name and drops outliers, and a price is withdrawn as soon as its inputs no longer support it rather than left behind to be read as current.

Get it

Pick it next to United States in pricing, or add it to a running US Stocks plan from your dashboard: you pay for the days left in your period and it renews with the plan.

Separate channel

overnight.quotes and the /overnight routes, so your stocks.* integration does not change. Outside the overnight session the channel is silent. Quotes only: there is no overnight trades channel.

Symbols

The ones you already use: stocks as US:KO, ETFs under the ETF feed codes (US500ETF, US100ETF, USGOLD).

{
  "action": "subscribe",
  "channels": ["overnight.quotes"],
  "symbols": ["US:KO", "US:JPM"]
}

{
  "type": "quote",
  "channel": "overnight.quotes",
  "asset": "stocks",
  "symbol": "US:KO",
  "bid": "62.3914",
  "ask": "62.4367",
  "mid": "62.4141",
  "session": "overnight",
  "dispersion_bps": 5.25,
  "ts": 1789808856800
}

curl -sS "https://api.tickerlayer.com/overnight/quote/US:KO" \
  -H "x-api-key: <YOUR_API_KEY>"

{
  "symbol": "US:KO",
  "bid": 62.3914,
  "ask": 62.4367,
  "mid": 62.4141,
  "session": "overnight",
  "dispersion_bps": 5.25,
  "timestamp": 1789808856800
}

GET /overnight/symbols lists the covered symbols and whether the session is open; GET /overnight/snapshot?symbols=US:KO,US:JPM returns several quotes in one call, or all of them when symbols is left out.

Overnight full spread

By default bid and ask sit at the aggregated half spread. Subscribe with "spread": "full" (or add ?spread=full to the REST routes) and they widen to the spread the night market is quoting, around the same mid: a thin book at the open shows as a wide spread instead of being averaged away. Same frame, same fields.

{
  "action": "subscribe",
  "channels": ["overnight.quotes"],
  "symbols": ["US:KO", "US:JPM"],
  "spread": "full"
}