Stocks · Dark pool, large prints and captured events

Stocks prints large

Large equity prints, lit and off-exchange, newest first.

GET/v1/stocks/prints/largestocksPrintsLarge

API Developer MCP tool: stocks_prints_large Paginated History-bounded Dataset: equities

On this page

Example request
Parameters
Response
Example response
Related

The large prints the platform captured for up to ten symbols on an exchange date, newest first, paged back in time with cursor_id. Only prints of at least $25,000 (or off-exchange prints of at least 1,000 shares) are retained, so smaller min_notional values do not reveal smaller prints; prior-session backfills keep prints of at least $250,000. venue separates lit exchanges from off-exchange facilities; flags mark odd lot, form T, average price, derivatively priced, prior reference price, late, intermarket sweep, contingent, official and corrected prints. Served from the platform's capture of equity prints: the tickers it captures are the always-on liquid ETFs plus tickers requested on demand (up to eight at a time, each for five minutes after the last request), so a symbol seen for the first time returns data only from the moment capture began; meta.coverage.captured_since says when. Use /v1/stocks/dark-pool/trades for the full tape of any symbol.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/prints/large" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbols=AAPL,MSFT,NVDA

const params = new URLSearchParams({
  symbols: "AAPL,MSFT,NVDA",
});
const res = await fetch(`https://api.ordermap.si/v1/stocks/prints/large?${params}`, {
  headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);
// Paginated: repeat with cursor_id set to pagination.next_cursor_id until it is null.

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

7 parameters, none required.

Parameter	Type and limits	Description
`symbols`queryoptional	array<string>comma-separated in one parameter1 to 10 itemseach at most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$	Comma-separated ticker symbols, at most 10. Defaults to SPY.
`date`queryoptional	stringdate	Exchange date, YYYY-MM-DD. Defaults to the latest captured trading date.
`venue`queryoptional	stringalloff_exchangelitdefault all	all (default), off_exchange or lit.
`min_notional`queryoptional	numbermin 0max 1000000000000000	Only prints of at least this dollar value.
`min_size`queryoptional	numbermin 0max 1000000000000	Only prints of at least this many shares.
`limit`queryoptional	integerdefault 200min 1max 500	Maximum rows to return.
`cursor_id`queryoptional	stringat most 1024 characters	Opaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

Response

Status	Meaning	Body
`200`	Successful response.	Schema below
`400`	Invalid, unknown or repeated parameters, or an invalid cursor.	Error object
`401`	Missing or invalid API key.	Error object
`403`	The plan, dataset release or account state does not allow this request.	Error object
`422`	The request is valid but no data exists for it.	Error object
`429`	Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After	Error object
`500`	Internal error.	Error object
`503`	Data temporarily unavailable; retry after Retry-After seconds.Retry-After	Error object
`504`	The request timed out.	Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

dataarray<object>required12 fields inside
- conditionsarray<integer>requiredTrade condition codes.
- exchangeintegerrequiredNumeric id of the reporting venue; see /v1/stocks/exchanges.
- flagsarray<string>requiredClassification flags of the print.
- notionalnumberrequiredPrice times size, in dollars.
- off_exchangebooleanrequiredReported through a trade reporting facility.
- participant_timestampintegerunix-msrequiredTime the exchange or facility stamped the print. Unix epoch milliseconds (UTC).
- pricenumberrequiredPrice.
- sizenumberrequiredSize in shares.
- symbolstringrequiredTicker symbol.
- timestampintegerunix-msrequiredTime the consolidated feed stamped the print. Unix epoch milliseconds (UTC).
- trade_idstringrequiredPlatform id of the print, stable across requests.
- trf_idinteger | nullrequiredFacility that received an off-exchange report.
metaobjectrequiredMeta object
paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "conditions": [
        12
      ],
      "exchange": 4,
      "flags": [
        "form_t"
      ],
      "notional": 3006000,
      "off_exchange": true,
      "participant_timestamp": 1792101600120,
      "price": 601.2,
      "size": 5000,
      "symbol": "SPY",
      "timestamp": 1792101600123,
      "trade_id": "SPY-1x9k2m",
      "trf_id": 201
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 200,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.

Example request

Parameters

Response

200 response body

Example response

Related