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

# Retrieve OI Change

`GET /api/market/oi-change`

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.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/revisions/0b37cadfb125/schema)