Docs
Flowseeker/API Reference/Contract

Raw enriched trades for a contract

GEThttps://flow-api.skylit.ai/v1/contract/{symbol}/trades

Same enriched trade shape as /v1/underlying/{ticker}/trades, scoped to a single OPRA contract. Because the contract is fixed, chain-level filters (moneyness, strike, DTE, expiration) do not apply here.

Authorization

Authorization: Bearer <your API key>

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

Path parameters

  • symbolstringrequired

    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.)

Query parameters

  • startstring

    Lower time bound — RFC 3339 or Unix seconds. Defaults to start-of-trading-day.

  • endstring

    Upper time bound — RFC 3339 or Unix seconds. Defaults to now.

  • limitintegerdefault 50min 1 · max 500
  • only_sweepsboolean
  • only_multi_legboolean
  • exclude_multi_legboolean
  • min_premiumnumberdoublemin 0

Responses

  • 200

    Enriched trades for the contract.

  • 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?