Beta. The Skylit API and MCP server are in Beta with limited access. Request access and we'll let you know when yours opens.The server exposes 42 tools . Each call costs the same credits as the
equivalent REST endpoint; the cost is shown per tool below and your remaining
balance is returned in each result's meta.
Every tool wraps a Skylit REST endpoint 1:1 — same auth, same credit cost,
same JSON. The Endpoint column gives the underlying path; for the full
request parameters and response schema of any endpoint, see the
API Reference . For example, flow_feed is the
GET /v1/flow/{ticker}heat_* tools map to the Heatseeker heatmap endpoints
(api.skylit.ai); everything else maps to Flowseeker (flow-api.skylit.ai).
Find valid symbols and the active universe before calling analytics tools.
Tool Returns Endpoint Credits flow_searchSearch underlyings by ticker fragment GET /v1/underlying/search1 list_active_underlyingsEvery underlying that traded options on a date, ranked by premium GET /v1/underlying1 expirationsAvailable expiration dates for an underlying, with contract counts GET /v1/underlying/{ticker}/expirations1
Scored options flow for a ticker or a single trade.
Tool Returns Endpoint Credits flow_feedRecent scored trades (Flow Score, FlowBonus) + VWF/SDF/FIR aggregates GET /v1/flow/{ticker}1 trade_scoreFull scoring + context for one trade id (from a flow_feed row) GET /v1/score/{trade_id}1 aggregate_scoreComposite + VWF/SDF/FIR across one or more trailing timeframes GET /v1/aggregate/{ticker}3 flow_aggregateServer-side rollup over an arbitrary [start_time, end_time] window GET /v1/flow/{ticker}/aggregate3
Tool Returns Endpoint Credits sweepsAggregated multi-exchange sweeps with venues, premium, moneyness, score GET /v1/sweeps/{ticker}3 flow_momentumLive 5m/30m/1h flow vs trailing baseline, with z-scores + trend label GET /v1/flow/{ticker}/momentum3 flow_baselineTrailing per-time-of-day baseline flow_momentum compares against GET /v1/flow/{ticker}/baseline3
Tool Returns Endpoint Credits flow_strikesTop-N strikes by net/total premium with bull/bear split + OI context GET /v1/flow/{ticker}/strikes3 flow_tideBucketed bullish vs bearish premium with cumulative net premium GET /v1/flow/{ticker}/tide3 by_strikeStrike-level distribution of a day's flow, optionally by DTE band GET /v1/underlying/{ticker}/by-strike3
Single-day and weekly top lists, plus unusual-activity scanners.
Tool Returns Endpoint Credits top_underlyings_dailyTop underlyings by single-day flow (call/put split, net premium, ratio) GET /v1/underlying/top/daily1 top_underlyings_weeklySame, over the trailing week GET /v1/underlying/top/weekly1 top_contracts_dailySingle-day top-contract screener (premium / volume / OI / sweeps) GET /v1/contract/top/daily1 top_contracts_weeklySame, over the trailing week GET /v1/contract/top/weekly1 unusual_volumeContracts with anomalous volume vs an avg_period baseline (RVOL) GET /v1/contract/unusual-volume3 unusual_oiContracts with significant open-interest changes (opening vs closing) GET /v1/contract/unusual-oi3
Tool Returns Endpoint Credits chain_bull_bearChain-level bull/bear/neutral % with call- and put-only breakdowns GET /v1/chain-bull-bear/{ticker}3 contract_bull_bearBull/bear/neutral % for a single OPRA contract GET /v1/contract-bull-bear/{symbol}1 chain_ratioChain-level ask/bid/mid + aggression ratios with a bias interpretation GET /v1/chain-ratio/{ticker}1 contract_ratioSame bid/ask/mid pressure for a single OPRA contract GET /v1/contract-ratio/{symbol}1
Tool Returns Endpoint Credits underlying_statsDaily aggregate stats for an underlying (premium, volume, net, OI) GET /v1/underlying/{ticker}/stats1 contract_statsDaily aggregate stats for a contract (volume, OI, premium, IV) GET /v1/contract/{symbol}/stats1 vol_oiVol/OI accumulation analysis; distinguishes new positioning from closing GET /v1/vol-oi/{ticker}1 moneynessPremium/sentiment split across deep_itm…deep_otm + detected patterns GET /v1/moneyness/{ticker}1
Tool Returns Endpoint Credits option_chainFull chain at an expiration (per-strike call/put volume, OI, premium) GET /v1/underlying/{ticker}/chain3 underlying_chartIntraday OHLC-style bars for an underlying GET /v1/underlying/{ticker}/chart3 contract_chartIntraday OHLC-style bars for a single contract GET /v1/contract/{symbol}/chart3 underlying_rvolRelative-volume bars for an underlying (format=summary for stats only) GET /v1/underlying/{ticker}/rvol1 contract_rvolRelative-volume bars for a single contract GET /v1/contract/{symbol}/rvol1
Tool Returns Endpoint Credits market_overviewMarket-wide flow for the day + top tickers by premium GET /v1/market/overview3 market_tideBucketed net call/put premium time series with an SPY overlay GET /v1/market/tide3 market_breadthSPY/QQQ/IWM sentiment, advance/decline, per-sector rotation GET /v1/flow/market-breadth3 sector_flowSector/industry flow aggregation with top-contributor tickers GET /v1/flow/sector/{sector}3
Off-exchange (TRF) prints. No side / BBO / greeks — these are raw block prints.
Tool Returns Endpoint Credits dark_pool_tradesPaginated off-exchange prints (filters: tickers / date range / notional / venue / sector); $1M+ by default, span capped at 31 days GET /v1/dark-pool/trades5 dark_pool_top_printsTop-N largest prints for a ticker over a trailing window, ordered by notional GET /v1/dark-pool/top-prints/{ticker}3
Tool Returns Endpoint Credits heat_heatmapCurrent per-strike gamma/vanna heatmap + live velocity (multi-symbol) GET /v1/heatmap1 heat_levelsKey levels only: classified nodes (king, gatekeeper, pika, barney, significant), strongest first, with distance from spot GET /v1/gex/levels1 heat_historical_heatmapReplay the heatmap at a past instant (up to 365 days back) GET /v1/historical5
Check your balance and limits before large pulls.
Tool Returns Endpoint Credits account_usageBalance in credits and US dollars, unlimited flag, and the limits that apply GET /v1/account0
Last updated Sep 26, 2026
Was this page helpful?