Docs
Flowseeker/API Reference/Underlying

Raw enriched trades for a ticker

GEThttps://flow-api.skylit.ai/v1/underlying/{ticker}/trades

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. See OptionTradeRow below.

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Path parameters

  • tickerstringrequired

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

Query parameters

  • startstring

    Lower time bound — ISO 8601 (e.g. 2026-01-12T09:30:00Z) or Unix seconds. Defaults to start-of-trading-day.

  • endstring

    Upper time bound — ISO 8601 or Unix seconds. Defaults to now.

  • limitintegerdefault 50min 1 · max 500
  • only_sweepsbooleandefault false
  • only_multi_legbooleandefault false
  • exclude_multi_legbooleandefault false
  • moneynessstring
    ITMATMOTM
  • min_moneyness_pctnumberdouble
  • max_moneyness_pctnumberdouble
  • min_premiumnumberdoublemin 0
  • min_dteinteger
  • max_dteinteger
  • min_strikenumberdouble
  • max_strikenumberdouble
  • expirationstringdate

Responses

  • 200

    Filtered enriched trades.

  • 400

    Request validation failed.

  • 401

    Missing or invalid API key.

  • 402

    The account's shared Skylit credit balance is lower than this route's cost. Top up to continue. Carries X-Credits-Remaining: 0.

  • 429

    Per-minute rate limit exceeded.

Response fields

  • dataobject[]required
    • dateintegerrequired

      Days since 1970-01-01 (compact session date).

    • tsEventintegerint64required

      Trade event timestamp in milliseconds since epoch.

    • tsEventUsintegerint64

      Microsecond-precision timestamp (contract-trades endpoint only).

    • instrumentIdintegerint64required
    • rawSymbolstringrequired
    • tickerstringrequired
    • expirationintegerrequired

      Expiration as days since 1970-01-01.

    • strikenumberdoublerequired
    • rightstringrequired
      CP
    • dteintegerrequired
    • pricenumberdoublerequired
    • sizeintegerrequired
    • sidestringrequired

      Granular execution-side label — BB (below bid), B (bid), AB (above bid), M (mid), BA (below ask), A (ask), AA (above ask), or N (no BBO).

      BBBABMBAAAAN
    • publisherIdintegerrequired
    • bidPxnumberdouble
    • askPxnumberdouble
    • bidSzinteger
    • askSzinteger
    • neutralSzintegerrequired
    • totalPremiumnumberdoublerequired
    • spreadnumberdouble
    • underlyingPricenumberdoublerequired
    • ivnumberdouble
    • moneynessstringrequired
      ITMATMOTM
    • moneynessPercentnumberdoublerequired
    • openInterestintegerrequired
    • prevOiintegerrequired
    • prevClosenumberdouble
    • prevCloseAgeinteger

      Trading days back the prevClose came from (0 = yesterday).

    • priceChangenumberdouble
    • dailyVolumeintegerrequired
    • sweepTradebooleanrequired
    • blockTradebooleanrequired
    • multiLegbooleanrequired
    • ivDirectionintegerrequired

      -1 = down, 0 = flat/unknown, 1 = up.

      -101
    • ingestionTimestampintegerint64required

      Server ingest time in milliseconds since epoch.

    • prevIvnumberdouble
    • nextIvnumberdouble
    • premiumPercentileinteger

      Bucketed premium percentile band (0 = below P50, 99 = P99+).

      05075909599
    • flowScoreinteger
    • chainBidPctnumberdouble
    • chainAskPctnumberdouble
    • contractBidPctnumberdouble
    • contractAskPctnumberdouble
    • aggCountinteger
    • aggTotalPremiumnumberdouble
    • aggTotalSizeinteger
    • mlSiblingboolean

      True when this leg was included via spread association rather than its own filter match.

    • strategyGroupIdstring
    • strategyTypestring
    • strategyLegCountinteger
    • earningsDteinteger
    • nextEarningsDateinteger
    • cacheMissboolean
    • sectorstring
    • industrystring
  • metaobjectrequired
    • timestampstringdate-timerequired

      Server-side timestamp the response was generated at.

    • requestIdstringrequired

      Short opaque ID for log correlation.

Last updated

Was this page helpful?