---
title: "Get Historical Options Market Trades"
method: GET
path: "/v1/history/option-trades"
tags: ["market-history-data"]
---

# Get Historical Options Market Trades

`GET /v1/history/option-trades`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/history/option-trades`
- Auth: none required
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/history/option-trades/get.ts> (a function with typed inputs; its response is checked against the schema)

Get Historical Options Market Trades by `optionType`. If `optionType` is not specified in request parameters, both CALL & PUT markets will be returned
- On a single query request you can retrieve data over a 7 day window, with the data available for the last 90 days
- Only max 100 data will be returned during the window
- Default: If `createdAtDatetime` is omitted, the endpoint returns a rolling 7-day window of trade history, starting from the most recent trade across all options markets

## Query parameters

- `createdAtDatetime[gte]` string, date-time: ISO 8601 with millisecond as string
- `createdAtDatetime[lte]` string, date-time: ISO 8601 with millisecond as string
- `optionType` 'CALL' | 'PUT': Type of Option market

## Response `200`

OK

- OptionTrade[]
  - `symbol` string, required: market symbol. E.g. `BTC-USDC-20241004-70000-C` for OPTION markets.
  - `tradeId` string, required
  - `price` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quantity` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `side` string, required: order side can have the following string values `"BUY"`, `"SELL"`
  - `isTaker` boolean, required
  - `createdAtDatetime` string, date-time, required: ISO 8601 with millisecond as string
  - `createdAtTimestamp` string, string, required: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `optionType` 'CALL' | 'PUT', required: Type of Option market
  - `otcTradeId` string, required: unique numeric (i64) identifier generated on Bullish side expressed as a string value

## Other responses

- `400`: Bad Request
- `404`: Resource Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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