Skip to main content

tracer.stock_perps.klines#

Per-symbol OHLCV for stock perpetuals (NVDA-USD, AAPL-USD, etc.

SYNTAX#

tracer.stock_perps.klines: SourceHandle  // Stock-perp OHLCV (series)

ARGUMENTS#

  • opts.symbol (string) — Stock-perp symbol.
  • opts.exchange (string) — 'hyperliquid' or 'lighter'.

RETURNS#

GenericSeriesSourceData — { values: { time, o, h, l, c, v } }

REMARKS#

Generic series — rows arrive at the source's native cadence and are NOT 1:1 with chart candles. To align, match values.time[i] (unix SECONDS) against candles[j].time; do not assume row i corresponds to bar i (values.c[i] is generally NOT bar i's value). (Per-candle kinds like oi/funding are the exception — those are forward-filled to your candles.)

EXAMPLE#

const sk = tracer.stock_perps.klines;
function onBar(i, ctx) {
  // generic series: match by timestamp, not bar index (see REMARKS)
  const j = sk.values.time.lastIndexOf(candles[i].time);
  plot("close", j >= 0 ? sk.values.c[j] : null);
}