v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB

Dark Pool

Paginated off-exchange (TRF) prints

Server-side filtered dark-pool prints from the off-exchange tape (FINRA TRF, publisher FINN/FINC). 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.

get/v1/dark-pool/trades

Query parameters

tickersstring

Example:AAPL,NVDA

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

datestring date

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

date_startstring date

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

date_endstring date

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

time_startstring

Example:09:30

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

time_endstring

Example:16:00

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

min_notionalnumber double

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

max_notionalnumber double

min_sizeinteger

max_sizeinteger

min_pricenumber double

max_pricenumber double

sectorsstring

Comma-separated GICS sectors to include.

industriesstring

Comma-separated GICS industries to include.

venue'FINN' | 'FINC'

Reporting venue filter. Omit for both.

limitinteger

Page size (server caps at 5000).

offsetinteger

Row offset for pagination.

order'asc' | 'desc'

Sort by trade time.

Response

Paginated dark-pool prints for the requested filters.

Example response

{
  "data": [
    {
      "timestamp": "2026-07-02T14:31:05.123Z",
      "ticker": "SPY"
    }
  ],
  "meta": {
    "requestId": "d7574836"
  }
}