Options Flow Summary

API Enterprise

The options flow of every US-listed underlying on one session, one row each: print counts by type, premium, the buyer, seller and sentiment shares of premium, and the ORTEX directional flow score.

Built for enterprise consumers: the response is uncharged (no credits), and every row carries the full instrument-identity block 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.
  • Trade Date: The US/Eastern session the row summarizes. (YYYY-MM-DD format).
  • Prints: Options flow prints on the underlying in the session.
  • Premium USD: Total premium of those prints, in US dollars.
  • Sweeps: Prints classed as sweeps.
  • Blocks: Prints classed as blocks.
  • Large: Prints classed as large.
  • Unusual Sweeps: Prints classed as unusual sweeps.
  • Buyer Premium Pct: Share of premium that printed at or through the ask (buyer initiated).
  • Seller Premium Pct: Share of premium that printed at or through the bid (seller initiated).
  • Mid Premium Pct: Share of premium that printed inside the quote.
  • Bullish Premium Pct: Share of premium with bullish sentiment: calls bought and puts sold.
  • Bearish Premium Pct: Share of premium with bearish sentiment: calls sold and puts bought.
  • ORTEX Bullish Premium Pct: Share of premium whose break-even was above the underlying's price at the print.
  • ORTEX Bullish Prints Pct: The same share counted in prints rather than premium.
  • ORTEX Flow Score: The ORTEX directional flow score, -100 (bearish) to +100 (bullish).

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). Only underlyings with at least one print in the session appear.

How the shares and the score are built

The buyer, seller, mid, bullish and bearish shares are taken over the premium of the prints that have the quote at execution, which is held from the 19 October 2026 session; earlier sessions report them as null. The ORTEX flow score signs every print by its payoff direction against the underlying: its break-even versus the underlying's last price in the 20 minutes before the print (the print's ortexBetDirection on the Options Flow endpoint). The bullish share of premium and the bullish share of prints are combined and re-centred on zero, then damped where the evidence is thin - few prints on either side, a small net bet or under $5M of premium - so +65 on 3,000 prints means more than +65 on 30. Prints whose underlying did not trade in that window are left out of the score; when none traded the score is null.

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
*/*