---
title: "Retrieve OI Change"
method: GET
path: "/api/market/oi-change"
---

# Retrieve OI Change

`GET /api/market/oi-change`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/market/oi-change`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/market/oi-change/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns non-Index/non-ETF contracts and OI change data with the highest OI change.

## Query parameters

- `date` string, date
- `limit` integer
- `order` 'desc' | 'asc'

## Response `200`

Successful response with OI change data.

- OIChangeResponse
  - `data` OIChangeEntry[]
    - `avg_price` string: The average price of the option contract.
    - `curr_date` string, date: The current trading date.
    - `curr_oi` integer: The current open interest.
    - `last_ask` string: The last ask price.
    - `last_bid` string: The last bid price.
    - `last_date` string, date: The previous trading date.
    - `last_fill` string: The last fill price.
    - `last_oi` integer: The previous open interest.
    - `oi_change` string: The percentage change in open interest.
    - `oi_diff_plain` integer: The absolute change in open interest.
    - `option_symbol` string: The option symbol of the contract.
    - `percentage_of_total` string: The percentage of the total open interest change.
    - `prev_ask_volume` integer: The previous ask volume.
    - `prev_bid_volume` integer: The previous bid volume.
    - `prev_mid_volume` integer: The previous midpoint volume.
    - `prev_multi_leg_volume` integer: The previous multi-leg volume.
    - `prev_neutral_volume` integer: The previous neutral volume.
    - `prev_stock_multi_leg_volume` integer: The previous stock multi-leg volume.
    - `prev_total_premium` string: The previous total premium.
    - `rnk` integer: The rank based on OI change.
    - `trades` integer: The number of trades.
    - `underlying_symbol` string: The underlying symbol of the option contract.
    - `volume` integer: The total volume.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)