Raw flow feed for a ticker (Flow Score + FlowBonus per trade)

curl --request GET \
  --url https://flow-api.skylit.ai/v1/flow/{ticker} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flow-api.skylit.ai/v1/flow/{ticker}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://flow-api.skylit.ai/v1/flow/{ticker}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://flow-api.skylit.ai/v1/flow/{ticker}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flow-api.skylit.ai/v1/flow/{ticker}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "ticker": "<string>",
    "timeframe": "<string>",
    "trades": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "tradeId": "flow_188afe42c3a77af2_0",
        "optionType": "CALL",
        "strike": 123,
        "expiration": "2023-12-25",
        "dte": 1,
        "contracts": 2,
        "premium": 123,
        "price": 123,
        "bid": 123,
        "ask": 123,
        "mid": 123,
        "underlyingPrice": 123,
        "isSweep": true,
        "isMultiLeg": true,
        "moneyness": "DEEP_ITM",
        "scores": {
          "flowScore": 0,
          "flowScoreInterpretation": "strong_bullish",
          "flowBonus": 50,
          "flowBonusInterpretation": "high_conviction",
          "baseDirection": 123,
          "convictionMultiplier": 123
        },
        "dteCategory": "zero_dte",
        "dteFactor": 123,
        "dteMultiplier": 123,
        "spreadWidth": 123,
        "spreadWidthPct": 123,
        "liquidityGrade": "A",
        "exchangeCount": 123,
        "moneynessPct": 123,
        "moneynessWeight": 123,
        "combinedMoneynessDteWeight": 123,
        "delta": 123,
        "notionalDeltaExposure": 123,
        "openInterest": 1,
        "dailyVolume": 1,
        "volOiRatio": 123,
        "volOiScore": 123,
        "sizeOiRatio": 123,
        "sizeOiScore": 123,
        "oiIsZero": true,
        "rvol": 123,
        "rvolScore": 123,
        "rvolCategory": "<string>",
        "iv": 123,
        "ivChangePct": 123,
        "relativePremium": 123,
        "cluster": {
          "clusterId": "<string>",
          "clusterTradeCount": 2,
          "clusterTotalPremium": 123,
          "clusterTimeSpanSeconds": 1
        }
      }
    ],
    "aggregate": {
      "vwf": 123,
      "sdf": 123,
      "fir": 123
    },
    "tradeCount": 1,
    "sweepCount": 1,
    "totalPremium": 123,
    "queryTimeMs": 1
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "requestId": "d7574836"
  }
}

GET

flow

{ticker}

Raw flow feed for a ticker (Flow Score + FlowBonus per trade)

curl --request GET \
  --url https://flow-api.skylit.ai/v1/flow/{ticker} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flow-api.skylit.ai/v1/flow/{ticker}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://flow-api.skylit.ai/v1/flow/{ticker}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://flow-api.skylit.ai/v1/flow/{ticker}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://flow-api.skylit.ai/v1/flow/{ticker}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "ticker": "<string>",
    "timeframe": "<string>",
    "trades": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "tradeId": "flow_188afe42c3a77af2_0",
        "optionType": "CALL",
        "strike": 123,
        "expiration": "2023-12-25",
        "dte": 1,
        "contracts": 2,
        "premium": 123,
        "price": 123,
        "bid": 123,
        "ask": 123,
        "mid": 123,
        "underlyingPrice": 123,
        "isSweep": true,
        "isMultiLeg": true,
        "moneyness": "DEEP_ITM",
        "scores": {
          "flowScore": 0,
          "flowScoreInterpretation": "strong_bullish",
          "flowBonus": 50,
          "flowBonusInterpretation": "high_conviction",
          "baseDirection": 123,
          "convictionMultiplier": 123
        },
        "dteCategory": "zero_dte",
        "dteFactor": 123,
        "dteMultiplier": 123,
        "spreadWidth": 123,
        "spreadWidthPct": 123,
        "liquidityGrade": "A",
        "exchangeCount": 123,
        "moneynessPct": 123,
        "moneynessWeight": 123,
        "combinedMoneynessDteWeight": 123,
        "delta": 123,
        "notionalDeltaExposure": 123,
        "openInterest": 1,
        "dailyVolume": 1,
        "volOiRatio": 123,
        "volOiScore": 123,
        "sizeOiRatio": 123,
        "sizeOiScore": 123,
        "oiIsZero": true,
        "rvol": 123,
        "rvolScore": 123,
        "rvolCategory": "<string>",
        "iv": 123,
        "ivChangePct": 123,
        "relativePremium": 123,
        "cluster": {
          "clusterId": "<string>",
          "clusterTradeCount": 2,
          "clusterTotalPremium": 123,
          "clusterTimeSpanSeconds": 1
        }
      }
    ],
    "aggregate": {
      "vwf": 123,
      "sdf": 123,
      "fir": 123
    },
    "tradeCount": 1,
    "sweepCount": 1,
    "totalPremium": 123,
    "queryTimeMs": 1
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "requestId": "d7574836"
  }
}

Authorizations

Authorization

string

header

required

Skylit API key in the Authorization header (Authorization: Bearer fs_live_<key>). X-API-Key is also accepted.

Path Parameters

ticker

string

required

Underlying ticker symbol (uppercase, e.g. SPY, AAPL).

Example:

"SPY"

Query Parameters

timeframe

enum<string>

default:1h

Trailing window label for the request. Supported values: 5m, 15m, 1h, 4h, 1d.

Available options:

5m,

15m,

1h,

4h,

1d

limit

integer

default:100

Max trades returned. Server caps this at 500.

Required range: 1 <= x <= 500

min_premium

number<double>

Minimum total premium per trade (USD).

Example:

50000

option_type

enum<string>

default:all

Filter to calls or puts. all returns both.

Available options:

call,

put,

all

trade_type

enum<string>

default:all

Filter by trade type. Comma-separated for multiple.

Available options:

sweep,

multi_leg,

all

moneyness

enum<string>

default:all

Moneyness category filter. Comma-separated for multiple (e.g. otm,deep_otm). Unknown tokens are ignored.

Available options:

deep_itm,

itm,

atm,

otm,

deep_otm,

all

start_time

string

Optional lower bound for the trade window. Accepts RFC 3339 (2026-05-27T13:30:00Z) or Unix seconds. Omit to use the timeframe.

end_time

string

Optional upper bound (RFC 3339 or Unix seconds).

max_premium

number<double>

Maximum total premium per trade (USD).

min_contracts

integer

Minimum contract size per trade.

Required range: x >= 0

max_contracts

integer

Maximum contract size per trade.

Required range: x >= 0

single_leg_only

boolean

default:false

If true, exclude trades flagged as part of a multi-leg structure.

min_dte

integer

Minimum days to expiration.

max_dte

integer

Maximum days to expiration.

min_strike

number<double>

Minimum strike price (inclusive).

max_strike

number<double>

Maximum strike price (inclusive).

expiration

string<date>

Filter to a single expiration date (YYYY-MM-DD).

conviction_weights

string

Optional JSON object overriding the Flow Score conviction weights. Weights must be non-negative and sum to within 0.95–1.05, else 400.

min_flow_score

integer

Filter to trades with flowScore ≥ this value (-100..100).

Required range: -100 <= x <= 100

min_flow_bonus

integer

Filter to trades with flowBonus ≥ this value.

Required range: x >= 0

min_rvol

number<double>

Filter to trades with relative volume ≥ this multiple.

Required range: x >= 0

Example:

2

include_clusters

boolean

default:true

If true, attach cluster* fields when a trade is part of a multi-leg cluster (sweep, condor, etc.).

date

string<date>

Trading date (YYYY-MM-DD). Defaults to current trading date.

Example:

"2026-05-27"

Response

Flow feed for {ticker}.

data

object

required

Show child attributes

Flow

Sector

Market

Sweeps

Analytics

Scoring

Ratios

Underlying

Contract

Dark Pool

Meta

Raw flow feed for a ticker (Flow Score + FlowBonus per trade)

Authorizations

Path Parameters

Query Parameters

Response