---
title: "Retrieve Historic Data"
method: GET
path: "/api/option-contract/{id}/historic"
---

# Retrieve Historic Data

`GET /api/option-contract/{id}/historic`

Returns historic data for the given option contract for each trading day.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful response with historic data.

- HistoricDataResponse
  - `chains` HistoricDataEntry[]
    - `ask_volume` integer — The amount of volume that happened on the ask side.
    - `avg_price` string — The volume weighted average fill price of the contract.
    - `bid_volume` integer — The amount of volume that happened on the bid side.
    - `cross_volume` integer — The amount of cross volume (transactions with the cross trade code).
    - `date` string, date — A trading date in ISO format.
    - `floor_volume` integer — The amount of floor volume (transactions with the floor trade code).
    - `high_price` string — The highest fill on the contract.
    - `implied_volatility` string — The implied volatility for the last transaction.
    - `iv_high` string — The highest implied volatility for the contract.
    - `iv_low` string — The lowest implied volatility for the contract.
    - `last_price` string — The last fill on the contract.
    - `last_tape_time` string, date-time — The last time there was a transaction for the given contract.
    - `low_price` string — The lowest fill on the contract.
    - `mid_volume` integer — The amount of volume that happened in the middle of the ask and bid.
    - `multi_leg_volume` integer — The amount of volume as part of a multileg trade.
    - `no_side_volume` integer — Volume on no identifiable side (e.g., late, out-of-sequence transactions).
    - `open_interest` integer — The open interest for the contract.
    - `stock_multi_leg_volume` integer — Volume as part of stock transactions and possibly other option contracts.
    - `sweep_volume` integer — Sweep volume (transactions with the sweep trade code).
    - `total_premium` string — The total option premium.
    - `trades` integer — The total number of transactions for this contract.
    - `volume` integer — The contract 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/versions/0b37cadfb125/schema)