Docs
Flowseeker/API Reference/Dark Pool

Paginated off-exchange (TRF) prints

GEThttps://flow-api.skylit.ai/v1/dark-pool/trades

Server-side filtered dark-pool prints from the off-exchange tape (FINRA TRF). Defaults to today (ET) with a $1,000,000 minimum notional (the blocks-by-default rule); pass min_notional=0 for the full firehose. The trade-date span is capped at 31 days per request — page with limit/offset or narrow the range for more. Prints carry no side, BBO, or greeks. Pagination state (limit, offset, count, hasMore) is returned in meta.

Authorization

Authorization: Bearer <your API key>

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

Query parameters

  • tickersstring

    Comma-separated tickers to include (e.g. AAPL,NVDA). Omit for all names.

  • datestringdate

    Single trade date (YYYY-MM-DD, ET). Defaults to today (ET).

  • date_startstringdate

    Inclusive start of a trade-date range (YYYY-MM-DD, ET). Max span 31 days.

  • date_endstringdate

    Inclusive end of a trade-date range (YYYY-MM-DD, ET). Max span 31 days.

  • time_startstring

    Inclusive lower bound of the time-of-day window (HH:MM, ET).

  • time_endstring

    Inclusive upper bound of the time-of-day window (HH:MM, ET).

  • min_notionalnumberdoubledefault 1000000

    Minimum notional (USD). Defaults to 1,000,000. Pass 0 for the firehose.

  • max_notionalnumberdouble
  • min_sizeintegermin 0
  • max_sizeintegermin 0
  • min_pricenumberdouble
  • max_pricenumberdouble
  • sectorsstring

    Comma-separated GICS sectors to include.

  • industriesstring

    Comma-separated GICS industries to include.

  • venuestring

    Reporting venue filter. Omit for both.

    FINNFINC
  • limitintegerdefault 500min 1 · max 5000

    Page size (server caps at 5000).

  • offsetintegerdefault 0min 0 · max 50000

    Row offset for pagination.

  • orderstringdefault desc

    Sort by trade time.

    ascdesc

Responses

  • 200

    Paginated dark-pool prints for the requested filters.

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

  • 403

    API key invalid, revoked or expired, or the account's API access is suspended (account_suspended).

  • 429

    Per-minute rate limit exceeded.

  • 503

    Underlying data source temporarily unavailable, or the credit balance could not be verified (credit_check_failed). Safe to retry.

Response fields

  • dataobject[]required
    • timestampstringdate-timerequired

      Trade time, ISO-8601 UTC (millisecond precision).

    • tickerstringrequired

      Underlying (dotted equity symbol, e.g. BRK.B).

    • pricenumberdoublerequired
    • sizeintegerrequired

      Shares.

    • notionalnumberdoublerequired

      price × size (USD).

    • venuestringrequired

      FINRA TRF reporting venue.

      FINNFINC
    • sectorstringrequired

      GICS sector of the underlying.

    • industrystringrequired

      GICS industry of the underlying.

  • metarequired

Last updated

Was this page helpful?