Per-contract call/put-aware bull/bear pressure

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

{
  "data": {
    "symbol": "<string>",
    "ticker": "<string>",
    "date": "2023-12-25",
    "timeframe": "<string>",
    "tradeCount": 1,
    "totalVolume": 1,
    "totalPremium": 123,
    "metrics": {
      "bullPct": 123,
      "bearPct": 123,
      "neutralPct": 123,
      "bullBearRatio": 123
    },
    "interpretation": {
      "description": "<string>"
    }
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "requestId": "d7574836"
  }
}

GET

contract-bull-bear

{symbol}

Per-contract call/put-aware bull/bear pressure

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

{
  "data": {
    "symbol": "<string>",
    "ticker": "<string>",
    "date": "2023-12-25",
    "timeframe": "<string>",
    "tradeCount": 1,
    "totalVolume": 1,
    "totalPremium": 123,
    "metrics": {
      "bullPct": 123,
      "bearPct": 123,
      "neutralPct": 123,
      "bullBearRatio": 123
    },
    "interpretation": {
      "description": "<string>"
    }
  },
  "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

symbol

string

required

OPRA option symbol in URL-safe form: {ticker}__{YYMMDD}{C|P}{strike×1000, 8 digits} — the ticker and the 15-character contract block are joined by a double underscore (__). For example, an AAPL $250 call expiring 2026-01-17 is AAPL__260117C00250000. (A space-padded 21-char OCC form such as AAPL 260117C00250000 is also accepted on some endpoints, but the __ form is canonical and works across all contract routes.)

Example:

"SPY__250516C00580000"

Query Parameters

date

string<date>

timeframe

enum<string>

default:1d

Available options:

5m,

15m,

1h,

4h,

1d

minPremium

integer

Required range: x >= 0

Response

Per-contract bull/bear analysis.

data

object

required

Show child attributes