Gainers / Losers

Overview

Gainers / Losers returns one entry per ticker for the requested window, summarizing call vs put premium and trade activity. Each entry carries bullishPremium, bearishPremium, total premium, premiumRatio (bearish over bullish), tradeCount, and volume.

curl -X POST https://api.quantdata.us/v1/options/tool/gainers-losers \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{}'

Selecting the time window

Gainers / Losers accepts sessionDate, timeRange, or neither. The two are mutually exclusive; if both are omitted, the most recent trading session is used.

Single-session, narrowed to a sector and short DTE

{
  "sessionDate": "2026-05-13",
  "filter": {
    "sectors": ["Technology"],
    "dteRange": { "min": 0, "max": 7 }
  }
}

Response shape

datais a map keyed by ticker, ordered alphabetically. Each entry summarizes that ticker's option-trade premium and volume for the window.

{
  "data": {
    "AAPL": {
      "bearishPremium": 4821330.50,
      "bullishPremium": 6128974.25,
      "premium": 11402108.75,
      "premiumRatio": 0.787,
      "tradeCount": 18472,
      "volume": 41208
    },
    "NVDA": {
      "bearishPremium": 9120448.10,
      "bullishPremium": 12880102.80,
      "premium": 23104550.90,
      "premiumRatio": 0.708,
      "tradeCount": 25319,
      "volume": 58844
    }
  }
}

Per-ticker fields:

• bullishPremium, bearishPremium: total premium for trades classified as bullish vs bearish, in dollars.
• premium: total premium across all trades for the ticker, in dollars.
• premiumRatio: bearishPremium / bullishPremium. Returns 0 when bullishPremium is zero.
• tradeCount: number of trades that contributed.
• volume: total contract count across those trades.

Filters

Convenience filter fields: tickers, sectors, industries, expirationDates, expirationDateRange, dteRange. All are optional. The filterExpression DSL is also accepted and can be combined with filter; both are evaluated as AND.

Filter expression · multi-ticker AND short DTE

{
  "timeRange": {
    "startTime": "2026-05-13T13:30:00Z",
    "endTime": "2026-05-13T20:00:00Z"
  },
  "filterExpression": {
    "conjunction": "AND",
    "filters": [
      { "field": "ticker", "operation": "=", "values": ["AAPL", "NVDA", "MSFT"] },
      { "field": "dte", "operation": "<=", "value": 14 }
    ]
  }
}

See Field Reference for the type and allowed values of every filterable field, and Filter Expression for the full DSL grammar.

Where to go next