# Skylit ## Docs - [Aggregate sentiment scoring across timeframes (VWF / SDF / FIR / Composite)](https://docs.skylit.ai/api-reference/analytics/aggregate-sentiment-scoring-across-timeframes-vwf-sdf-fir-composite.md): Returns a Composite directional score plus its VWF / SDF / FIR components for one or more trailing timeframes (intraday or multi-day). Optional moneyness breakdown, optional time-decay weighting, and a comparative trend block contrasting short- vs long-horizon sentiment. Reference: PRD Section 8. - [Moneyness breakdown with pattern detection](https://docs.skylit.ai/api-reference/analytics/moneyness-breakdown-with-pattern-detection.md): Splits calls and puts across `deep_itm / itm / atm / otm / deep_otm` buckets with premium, sentiment, percentage of total, and trade count. Surfaces detected patterns (e.g. heavy OTM call accumulation, ATM concentration, deep-OTM lottery tickets) and a directional `signal`/`dominantStrategy` interpr… - [Volume-vs-Open-Interest accumulation analysis](https://docs.skylit.ai/api-reference/analytics/volume-vs-open-interest-accumulation-analysis.md): Distinguishes new position building (accumulation) from position closing (distribution) by bucketing Vol/OI ratios per option type and moneyness band. Returns an overall accumulation score (0–100), an estimate of the share of volume representing new positions, and a one-token signal (`strong_accumul… - [Authentication](https://docs.skylit.ai/api-reference/authentication.md): Authenticate with a Skylit API key, and how credits and rate limits work. - [Bulk contract stats for a list of symbols](https://docs.skylit.ai/api-reference/contract/bulk-contract-stats-for-a-list-of-symbols.md): Returns a single-day `ContractStats` record per requested OPRA symbol. Symbols absent from the response had no activity that day. - [Contracts with significant OI changes](https://docs.skylit.ai/api-reference/contract/contracts-with-significant-oi-changes.md): Contracts whose open interest changed by at least `minOiChange` (or `minOiChangePct`) on the target date. `direction` narrows the result to opening (OI ↑) or closing (OI ↓) flow. - [Contracts with unusual relative volume](https://docs.skylit.ai/api-reference/contract/contracts-with-unusual-relative-volume.md): Contracts whose volume on the target date is anomalously high relative to a `avgPeriod`-day baseline. Filters cover RVOL, raw volume, OI dynamics, premium, IV, moneyness, sweep / multi-leg, and ticker include / exclude lists. Sortable by `rvol`, `volume`, `premium`, `volOi`, or `oiChange`. - [Daily history for a contract](https://docs.skylit.ai/api-reference/contract/daily-history-for-a-contract.md): Daily aggregates per trading day in `[startDate, endDate]` — total premium / volume, OI dynamics, bid/ask execution split, sweep and multi-leg shares, VWAP, last price, IV, and trade count. - [Daily stats for a single contract](https://docs.skylit.ai/api-reference/contract/daily-stats-for-a-single-contract.md) - [Intraday chart bars for a contract](https://docs.skylit.ai/api-reference/contract/intraday-chart-bars-for-a-contract.md): Time-bucketed bars for a single contract — granular bid/mid/ask execution split, premium and volume per side, daily cumulative totals, VWAP, and (when available) IV and 30D average baselines. - [Raw enriched trades for a contract](https://docs.skylit.ai/api-reference/contract/raw-enriched-trades-for-a-contract.md): Same enriched trade shape as `/v1/underlying/{ticker}/trades`, scoped to a single OPRA contract. - [Relative-volume bars for a contract](https://docs.skylit.ai/api-reference/contract/relative-volume-bars-for-a-contract.md): Same shape as `/v1/underlying/{ticker}/rvol` but scoped to a single contract. Returns `snake_case` keys. - [Top contracts by daily flow](https://docs.skylit.ai/api-reference/contract/top-contracts-by-daily-flow.md): Single-day top-contract screener with full-spectrum filters (premium / volume / OI / IV / DTE / strike windows, call vs put, sweep vs multi-leg). Sortable by `premium`, `volume`, `oi`, or `iv`. - [Top contracts by trailing-5-day flow](https://docs.skylit.ai/api-reference/contract/top-contracts-by-trailing-5-day-flow.md): Same shape as `/v1/contract/top/daily`, rolled up over the trailing 5 trading days ending on `date`. - [Aggregate flow over an arbitrary [start, end] window](https://docs.skylit.ai/api-reference/flow/aggregate-flow-over-an-arbitrary-[start-end]-window.md): Server-side aggregation across an arbitrary `[startTime, endTime]` window — no row cap. Returns trade/sweep counts, VWF/SDF/FIR, and a bullish/bearish/neutral premium split with a one-line interpretation. Useful for arbitrary slicing without paging the full trade list. - [Live momentum signal vs baseline (5m / 30m / 1h windows)](https://docs.skylit.ai/api-reference/flow/live-momentum-signal-vs-baseline-5m-30m-1h-windows.md): Compares the current 5-minute, 30-minute, and 1-hour flow against the trailing per-time-of-day baseline (`/v1/flow/{ticker}/baseline`). Returns z-scores for the 5-minute window and a one-token `trend` classification. - [Per-ticker net-premium time series ("flow tide")](https://docs.skylit.ai/api-reference/flow/per-ticker-net-premium-time-series-"flow-tide".md): Bucketed bullish vs bearish premium time series for a single ticker, with cumulative net premium and per-bucket VWF/SDF/FIR. The ticker-level analogue of `/v1/market/tide`. - [Raw flow feed for a ticker (Flow Score + FlowBonus per trade)](https://docs.skylit.ai/api-reference/flow/raw-flow-feed-for-a-ticker-flow-score-+-flowbonus-per-trade.md): Returns the most recent options trades for `{ticker}` within the requested timeframe, each scored on Skylit's directional Flow Score (-100 → +100) and conviction-weighted FlowBonus. The response also includes timeframe-level VWF / SDF / FIR aggregates. - [Strike-level flow concentration](https://docs.skylit.ai/api-reference/flow/strike-level-flow-concentration.md): Where the directional money is going for `{ticker}`. Top-N strikes by selected ordering (premium, net premium, volume, etc.) with bullish/bearish premium split, ask/bid mix, and OI context. Includes a top-3 concentration summary. - [Today's flow vs trailing average (with similar-days lookback)](https://docs.skylit.ai/api-reference/flow/todays-flow-vs-trailing-average-with-similar-days-lookback.md): Compares the current trading day's premium / volume / net premium / call-put ratio against the trailing 20-trading-day average for the same ticker. Returns absolute deltas, percentile rankings, and the five most-similar past trading days. - [Trailing per-time-of-day flow baseline (avg + stddev)](https://docs.skylit.ai/api-reference/flow/trailing-per-time-of-day-flow-baseline-avg-+-stddev.md): Time-of-day baseline buckets for `{ticker}` — average and standard deviation of trade count, premium, and FIR per intraday bucket over a configurable lookback window. The reference distribution behind `/v1/flow/{ticker}/momentum` z-scores. - [Live per-strike heatmap (one or more symbols)](https://docs.skylit.ai/api-reference/heatmap/live-per-strike-heatmap-one-or-more-symbols.md): Current per-strike heatmap for one or more symbols at the latest snapshot. Includes the live `velocityPct` per strike. Pass multiple comma-separated symbols for a single cross-asset (Trinity) call. - [Live SSE stream (one symbol per connection)](https://docs.skylit.ai/api-reference/heatmap/live-sse-stream-one-symbol-per-connection.md): A **Server-Sent Events** (`text/event-stream`) feed of live per-strike heatmap updates for **one** symbol. Open one connection per symbol. - [Replay per-strike heatmap at a past instant (one or more symbols)](https://docs.skylit.ai/api-reference/heatmap/replay-per-strike-heatmap-at-a-past-instant-one-or-more-symbols.md): The snapshot nearest `at` for one or more symbols — same shape as `/v1/heatmap` minus `velocityPct` (velocity is live-only). `at` may be up to 365 days in the past; if no snapshot exists at/near that instant the response is `404` with `code: no_data`. - [API Reference](https://docs.skylit.ai/api-reference/introduction.md): Skylit's real-time options-Greeks heatmaps as a versioned HTTP API. - [Bucketed market-wide net call premium / net put premium time series](https://docs.skylit.ai/api-reference/market/bucketed-market-wide-net-call-premium-net-put-premium-time-series.md): Returns the market-wide intraday "tide" — bucketed Net Call Premium and Net Put Premium series with both per-bucket and cumulative values, plus an SPY price overlay for context. Two directional flavors are emitted per bar: the standard `ncp`/`npp` (call-buying minus call-selling, etc.) and a `manual… - [Market-wide breadth, advance/decline, and sector rotation](https://docs.skylit.ai/api-reference/market/market-wide-breadth-advancedecline-and-sector-rotation.md): Combines SPY/QQQ/IWM aggregate sentiment with an advance/decline ratio (over directional FIR) and per-sector rotation signals. Ideal as a single "is the market risk-on or risk-off right now" probe. - [Market-wide flow overview for the current trading day](https://docs.skylit.ai/api-reference/market/market-wide-flow-overview-for-the-current-trading-day.md): Returns market-wide call/put premium, total volume, directional bullish/bearish premium, FIR, premium relative volume vs the trailing 20-day baseline at the same time of day, and the top 10 tickers by total premium. Optionally narrowed to a comma-separated ticker filter. - [This OpenAPI specification, as JSON](https://docs.skylit.ai/api-reference/meta/this-openapi-specification-as-json.md) - [Chain-level bid/ask/mid distribution](https://docs.skylit.ai/api-reference/ratios/chain-level-bidaskmid-distribution.md): Aggregates a ticker's full option chain to surface buying vs selling pressure (`askRatio`, `bidRatio`, `midRatio`, `aggressionRatio`), call/put balance, and ATM/OTM concentration. Returns a `bias`, `aggression`, and `confidence` interpretation. Reference: PRD Sections 12.3 and 14. - [Chain-level call/put-aware bull/bear pressure](https://docs.skylit.ai/api-reference/ratios/chain-level-callput-aware-bullbear-pressure.md): Folds option type into the bid/ask/mid signal: a call lifted at the ask is bullish, a put hit at the bid is also bullish (put selling), etc. Returns overall bull/bear/neutral percentages plus call-only and put-only bull breakdowns so callers can tell whether the directional pressure originates from… - [Per-contract bid/ask/mid distribution](https://docs.skylit.ai/api-reference/ratios/per-contract-bidaskmid-distribution.md): Single-contract counterpart to `/v1/chain-ratio/{ticker}`. Returns `askRatio`, `bidRatio`, `midRatio`, `aggressionRatio`, and a `bias`/`aggression`/`confidence` interpretation for one specific OPRA option symbol. - [Per-contract call/put-aware bull/bear pressure](https://docs.skylit.ai/api-reference/ratios/per-contract-callput-aware-bullbear-pressure.md): Single-contract counterpart to `/v1/chain-bull-bear/{ticker}`. Maps a contract's trades to bull/bear/neutral buckets using both side (bid/ask/mid) and option type, so a bullish put-seller and a bullish call-buyer both register as bullish pressure. - [Detailed scoring for a single trade](https://docs.skylit.ai/api-reference/scoring/detailed-scoring-for-a-single-trade.md): Returns sentiment, urgency, and confidence scores for an individual trade plus a spread-level breakdown and full trade context (ticker, strike, expiration, sweep/block flags, moneyness). Used to drill into a single row from `/v1/flow/{ticker}`. - [Sector- or industry-level flow aggregation](https://docs.skylit.ai/api-reference/sector/sector-or-industry-level-flow-aggregation.md): Aggregates options flow across all tickers in a GICS sector. The `{sector}` path parameter accepts either a sector ETF symbol (`XLK`, `XLF`, `XLE`, …) or a sector name (`Technology`, `Financials`, …). Returns sector-level metrics, top-contributor tickers, and an industry-level breakdown. - [Aggregated multi-exchange sweep activity](https://docs.skylit.ai/api-reference/sweeps/aggregated-multi-exchange-sweep-activity.md): Returns "logical sweeps" — multi-exchange splits of one large order grouped by contract within a one-second execution window. Each row carries the venue list, total contracts/premium, spread position, moneyness bucket, and Skylit Flow Score / FlowBonus. The summary block adds population-level Sweep… - [Bulk underlying stats for a list of tickers](https://docs.skylit.ai/api-reference/underlying/bulk-underlying-stats-for-a-list-of-tickers.md): Returns a single-day `UnderlyingStats` record per requested ticker. Tickers absent from the response had no options activity that day. - [Daily history for a ticker](https://docs.skylit.ai/api-reference/underlying/daily-history-for-a-ticker.md): Daily aggregates (premium, volume, call/put split, net premium) between `startDate` and `endDate` (inclusive), one row per trading day with activity. - [Daily stats for a single underlying](https://docs.skylit.ai/api-reference/underlying/daily-stats-for-a-single-underlying.md) - [Intraday chart bars for a ticker](https://docs.skylit.ai/api-reference/underlying/intraday-chart-bars-for-a-ticker.md): Returns time-bucketed bars aggregating options activity for the underlying (call/put volume + premium, P/C ratio, bid/ask execution split) plus the underlying stock price at each boundary. Backed by the same intraday rollup tables that power the chart modal in the Skylit UI. - [List traded expirations for a ticker](https://docs.skylit.ai/api-reference/underlying/list-traded-expirations-for-a-ticker.md): Returns each expiration that traded on `date`, with per-expiration call/put volume + premium and the unique-contract count. - [List underlyings active on a date](https://docs.skylit.ai/api-reference/underlying/list-underlyings-active-on-a-date.md): Lists every ticker that traded options on the requested date, ordered by total premium (descending). Useful as a starting point for discovery or for repopulating the universe of tradable tickers. - [Option chain snapshot](https://docs.skylit.ai/api-reference/underlying/option-chain-snapshot.md): Snapshot of the option chain for a single expiration on the requested date — call & put volume, premium, OI, last IV, and last trade price per strike, plus the underlying price. - [Prefix-search active tickers](https://docs.skylit.ai/api-reference/underlying/prefix-search-active-tickers.md): Case-insensitive prefix search over the active-tickers universe for the requested date. Use to power autocomplete UIs. - [Premium / volume by expiration for a strike](https://docs.skylit.ai/api-reference/underlying/premium-volume-by-expiration-for-a-strike.md): For a single strike on the underlying, breaks the requested window's premium and volume out by expiration date. Returns `snake_case` keys. - [Premium / volume by strike](https://docs.skylit.ai/api-reference/underlying/premium-volume-by-strike.md): Strike-level distribution of call/put premium, volume, and OI for the requested window, plus chain-wide aggregates and a max-pain estimate. Returns `snake_case` keys. - [Raw enriched trades for a ticker](https://docs.skylit.ai/api-reference/underlying/raw-enriched-trades-for-a-ticker.md): Returns the raw enriched trade rows that feed the chart bars and the live feed. Supports rich filtering — sweep-only / multi-leg, moneyness, premium floor, DTE / strike / expiration windows. - [Relative-volume bars for a ticker](https://docs.skylit.ai/api-reference/underlying/relative-volume-bars-for-a-ticker.md): Time-bucketed bars with call/put volume + premium and an average-volume baseline computed from `avgPeriod` recent days, plus aggregate RVOL stats. Returns `snake_case` keys. - [Top underlyings by daily flow](https://docs.skylit.ai/api-reference/underlying/top-underlyings-by-daily-flow.md): Top tickers for a single trading day, with call/put premium and volume splits, net premium, and call/put ratio. Sortable by `premium`, `volume`, `netPremium`, or `callPutRatio`. - [Top underlyings by trailing-5-day flow](https://docs.skylit.ai/api-reference/underlying/top-underlyings-by-trailing-5-day-flow.md): Same shape as `/v1/underlying/top/daily` but rolled up across the trailing 5 trading days ending on `date`. - [Atlas](https://docs.skylit.ai/atlas/overview.md): Skylit's market-data foundation — documentation coming soon. - [Best practices](https://docs.skylit.ai/best-practices.md): The key to mastering Heatseeker™ is to use it as context, not as a signal generator. - [Common pitfalls and mistakes](https://docs.skylit.ai/common-pitfalls-and-mistakes.md): Even with a powerful tool like Heatseeker™, traders often make predictable errors. - [Core Concepts](https://docs.skylit.ai/core-concepts.md): Each strike displays a value (positive or negative), and each value is represented by a color: - [Examples & Case Studies](https://docs.skylit.ai/examples-and-case-studies.md): GIven the fact that TSLA had an insane run up prior to October 2nd flush, our immediate thought process going into this morning should have been not to… - [FAQs](https://docs.skylit.ai/faqs.md): This section addresses the most common questions traders ask when learning to use Heatseeker™ and interpreting its signals effectively. - [Flowseeker](https://docs.skylit.ai/flowseeker/overview.md): Real-time and historical options-flow analytics for the Skylit platform. - [General Information](https://docs.skylit.ai/help-page/general-information.md): Skylit Team: - [Useful Threads](https://docs.skylit.ai/help-page/useful-threads.md): These threads contain daily charts/plots showing overlay of heatmaps on charts. - [Video Links](https://docs.skylit.ai/help-page/video-links.md): Collection of livestreams created by Glitch for various topics including onboarding, index trading, swing trading, Q\&A's, and other topics. - [Written Guides](https://docs.skylit.ai/help-page/written-guides.md): (written by John Wicks) - [How to read and use Heatseeker](https://docs.skylit.ai/how-to-read-and-use-heatseeker.md): Each node acts as a magnet, influencing price behavior as support or resistance depending on its location relative to price. - [Intended Audience](https://docs.skylit.ai/intended-audience.md): Heatseeker is designed for serious traders who want a greater understanding of: - [Introduction](https://docs.skylit.ai/introduction.md): Heatseeker is a powerful visual tool that simplifies how traders understand the invisible forces that drive price action in the market. - [Limitations](https://docs.skylit.ai/limitations.md): While Heatseeker™ provides a powerful view into dealer positioning, it’s not a crystal ball (although many still believe it to be). - [Navigating Skylit Web App](https://docs.skylit.ai/navigating-skylit-web-app.md): After signing up for Heatseeker Pro, you’ll receive access to the Skylit web app via email. - [Nexus](https://docs.skylit.ai/nexus/overview.md): Social trading for the Skylit platform — documentation coming soon. - [CASE STUDY: SPECULATIVE AND DECOY NODES](https://docs.skylit.ai/patternpedia/case-study-speculative-and-decoy-nodes.md): On occasion, a heatmap may display a far out of the money (OTM) node that is likely to be speculative or manipulative in nature. In both cases, traders… - [PATTERN: Rainbow Road](https://docs.skylit.ai/patternpedia/pattern-rainbow-road.md): This heatmap is characterized by having multiple prominent nodes of positive and negative values, in many cases bearing a resemblance to a rainbow. Another… - [PATTERN: RUG SETUP](https://docs.skylit.ai/patternpedia/pattern-rug-setup.md): When we have a yellow node stacked above a purple node with no obvious floor in sight, we can identify the setup as a rug setup. - [PATTERN: The Gatekeeper](https://docs.skylit.ai/patternpedia/pattern-the-gatekeeper.md): A Gatekeeper node is a commonly seen heatmap setup where a high-value node sits between price and further high-value nodes, preventing continuation. This… - [PATTERN: The Whipsaw](https://docs.skylit.ai/patternpedia/pattern-the-whipsaw.md): Price trades in a wide range, the edges of which are defined by the presence of at least two high value nodes with few prominent nodes in between. - [PATTERN: Trend](https://docs.skylit.ai/patternpedia/pattern-trend.md): Price fixates on a king node far away from spot with comparatively small counter-directional skew. As it trades towards the initial king node, it then… - [The Ten Commandments of Using Heatseeker](https://docs.skylit.ai/patternpedia/the-ten-commandments-of-using-heatseeker.md): 1. Thou shalt protect your existing capital at all costs. - [TOPPING PATTERNS / BOTTOMING PATTERNS:](https://docs.skylit.ai/patternpedia/topping-patterns-bottoming-patterns.md): This is a guide on how to spot potential higher timeframe trend shifts on the indices. We'll be looking primarily at the VEX positioning rather than the GEX… - [Welcome to Skylit](https://docs.skylit.ai/platform/overview.md): Documentation for the Skylit platform — market-intelligence tools for serious traders. - [Support](https://docs.skylit.ai/platform/support.md): Guides, community resources, and how to reach the Skylit team. - [Resources](https://docs.skylit.ai/resources.md): Glitch\Trades on Youtube, for all Heatseeker breakdowns and recaps: ## OpenAPI Specs - [flowseeker-openapi](https://docs.skylit.ai/flowseeker-openapi.yaml) - [openapi](https://docs.skylit.ai/openapi.yaml) ## Optional - [Launch Skylit App](https://app.skylit.ai)