---
title: "GET /options/vX/open-interest"
method: GET
path: "/options/vX/open-interest"
tags: ["us_options"]
---

# GET /options/vX/open-interest

`GET /options/vX/open-interest`

## Request

- Base URL: `https://api.massive.com`
- URL: `https://api.massive.com/options/vX/open-interest`
- Auth: API key in query parameter `apiKey`

Daily open interest for every US options contract as reported by OPRA, one row per contract per trading day, with the contract's underlying, type, expiration and strike.

## Query parameters

- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `root` string
- `root.any_of` string
- `root.gt` string
- `root.gte` string
- `root.lt` string
- `root.lte` string
- `underlying_ticker` string
- `underlying_ticker.any_of` string
- `underlying_ticker.gt` string
- `underlying_ticker.gte` string
- `underlying_ticker.lt` string
- `underlying_ticker.lte` string
- `contract_type` 'call' | 'put'
- `contract_type.any_of` 'call' | 'put'
- `expiration_date` string
- `expiration_date.gt` string
- `expiration_date.gte` string
- `expiration_date.lt` string
- `expiration_date.lte` string
- `strike_price` number, double
- `strike_price.gt` number, double
- `strike_price.gte` number, double
- `strike_price.lt` number, double
- `strike_price.lte` number, double
- `date` string
- `date.gt` string
- `date.gte` string
- `date.lt` string
- `date.lte` string
- `open_interest` integer
- `open_interest.gt` integer
- `open_interest.gte` integer
- `open_interest.lt` integer
- `open_interest.lte` integer
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string: If present, this value can be used to fetch the next page.
  - `request_id` string, required: A request id assigned by the server.
  - `results` object[], required: The results for this request.
    - `contract_type` string: The contract type. Possible values: call, put.
    - `date` string, date, required: The trading date the open interest applies to (formatted as YYYY-MM-DD).
    - `expiration_date` string, date: The date the contract expires (formatted as YYYY-MM-DD).
    - `open_interest` integer: The number of outstanding contracts that have not been closed or exercised, as of the last open interest update of the day.
    - `open_interest_change` integer: The change in open interest from the previous trading day (open_interest - previous_open_interest). Null when previous_open_interest is null.
    - `previous_open_interest` integer: The contract's open interest on the previous trading day. Null if the contract had no open interest reported that day, such as a new listing.
    - `root` string: The OCC root symbol of the contract (e.g., SPXW). Differs from the underlying for weekly roots and for contracts adjusted after a corporate action (e.g., AMCR1).
    - `strike_price` number, double: The strike price of the contract.
    - `ticker` string, required: The options ticker symbol (e.g., O:SPY260123C00687000).
    - `underlying_ticker` string: The ticker of the contract's underlying (e.g., SPX). Weekly and adjusted roots are folded in, so SPXW contracts report SPX and AMCR1 contracts report AMCR; see root to tell them apart.
  - `status` 'OK', required: The status of this request's response.

## Other responses

- `400`: An error message.

## Changes

- **2026-11-03** `efa0c51f70d1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/massive/apis/polygon-api/changes/options/vX/open-interest/get.md)

---

[API](https://skmtc.dev/massive/apis/polygon-api.md) - [All operations](https://skmtc.dev/massive/apis/polygon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/massive/apis/polygon-api/revisions/efa0c51f70d1?raw)