Options Flow

API Enterprise

Every options flow print in a region on one session date: one request returns each sweep, block and large print across all US-listed underlyings, with the quote it traded against and whether the buyer or the seller initiated it.

Built for enterprise consumers: the response is uncharged (no credits), and every row carries the full instrument-identity block of the underlying so it can be joined straight onto your own security master.

Available Data Points:

  • Company: The name of the company issuing the security.
  • Ticker: The ticker symbol associated with the security.
  • Operating MIC: The operating Market Identifier Code of the security.
  • MIC: The Market Identifier Code (MIC) for the traded security.
  • ISIN: The International Securities Identification Number for the security.
  • FIGI: The Financial Instrument Global Identifier.
  • Share Class FIGI: The Financial Instrument Global Identifier for the share class.
  • Ortex Company ID: Unique id for a company.
  • Ortex Security ID: Unique id for a security issued by a company.
  • Ortex Tradable item ID: Unique id for a listing of a security.
  • Ortex Tradable item main indicator: Indicates if the trading item is the main trading item for the security.
  • Tradable Item Currency: The currency of the tradable item.
  • Exchange Country: The country location of the exchange.
  • Timestamp: When the print executed, in UTC (ISO 8601, millisecond precision).
  • Trade Date: The US/Eastern session date of the print. (YYYY-MM-DD format).
  • Contract: The option contract symbol, e.g. TSLA__260909C00360000.
  • Option Type: call or put.
  • Strike: Strike price of the contract.
  • Expiry: Expiration date of the contract. (YYYY-MM-DD format).
  • Days To Expiry: Calendar days from the trade date to expiry.
  • Print Type: Sweep, Block, Large or Unusual Sweep.
  • Size Contracts: Contracts traded.
  • Premium USD: Total premium paid, in US dollars.
  • Average Price: Average fill price per share of the underlying (premium / contracts / 100).
  • Bid At Execution: National best bid for the contract when the print executed.
  • Ask At Execution: National best offer for the contract when the print executed.
  • Spread At Execution: Ask minus bid at execution.
  • Fill Position: Where the average fill sat in the quote: 0 = bid, 1 = ask, outside 0 to 1 = through the quote. Null on a locked or crossed quote.
  • Execution Side: above_ask, at_ask, mid, at_bid or below_bid.
  • Aggressor: buyer, seller or undetermined (inside the quote).
  • Sentiment: bullish (call bought or put sold), bearish (call sold or put bought) or neutral (inside the quote).
  • Break Even: Underlying price at expiry where the buyer breaks even: strike plus (call) or minus (put) the average price.
  • Underlying Price: The underlying's last traded price in the 20 minutes before the print; null when it did not trade.
  • ORTEX Bet Direction: bullish when the break-even is above the underlying price, bearish when below: the per-print sign the ORTEX flow score aggregates. Null without an underlying price.

Region and date

Coverage is US-listed options only. Use region to select the universe (defaults to US; ALL or any region that includes the US also works; a region with no US listings returns 400 invalidRegion) and date to select the US/Eastern session (defaults to the latest session with prints). A session typically holds 35,000 to 65,000 prints: page through them with page and page_size, or request CSV for the whole session in one response. Rows are oldest first.

What a print is

Every row is one qualifying options trade on a US-listed underlying, captured in real time from the consolidated options tape: a single print, or one order that filled as a burst of prints across exchanges. A sweep is one order filled across several exchanges within a short window (from $10k premium); a block a single large, typically negotiated print on one exchange (from $50k); a large print one above the notional threshold that is neither (from $100k); an unusual sweep a sweep far outside the contract's normal size. The side is the average fill compared with the national best bid and offer at execution; sentiment is the side times the contract type, so it can be reproduced from the row. The quote at execution is held from the 19 October 2026 session; earlier prints carry null quote fields, an average price derived from premium and size, and a contract symbol rebuilt from the ticker.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Contact [email protected]

Query Params
string
Defaults to US

Which instruments to return: a region name, a two-character ISO-2 country code, or "ALL" for the whole covered universe. Defaults to "US". An unrecognized value returns 400 invalidRegion.

date

The single date to return data for (defaults to the latest available). Format: YYYY-MM-DD.

integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; a value above the tier maximum is rejected with 400 invalidPageSize.

string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv
*/*