---
title: "Get Historical Market by Symbol"
method: GET
path: "/v1/history/markets/{symbol}"
tags: ["market-data"]
---

# Get Historical Market by Symbol

`GET /v1/history/markets/{symbol}`

## Request

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

Get Historical Market by Symbol. This endpoint will return specified market even if it is expired. Only applicable for this is applicable only for `DATED_FUTURE` and `OPTION` markets.

## Response `200`

OK

- Market
  - `marketId` string, required
  - `symbol` string, required: market symbol. E.g. `BTC-USDC-20241004-70000-C` for OPTION markets.
  - `baseSymbol` string, required: asset symbol as denoted in the world
  - `underlyingBaseSymbol` string: asset symbol as denoted in the world
  - `quoteSymbol` string, required: asset symbol as denoted in the world
  - `underlyingQuoteSymbol` string: asset symbol as denoted in the world
  - `quoteAssetId` string, required: unique asset ID
  - `baseAssetId` string, required: unique asset ID
  - `quotePrecision` integer, required: quote precision
  - `basePrecision` integer, required: base precision
  - `pricePrecision` integer, required: number of decimal digits 'after the dot' for price
  - `quantityPrecision` integer, required: number of decimal digits 'after the dot' for quantity
  - `costPrecision` integer, required: number of decimal digits 'after the dot' for cost, `price * quantity`
  - `priceBuffer` string, required: buffer range of limit price from the last traded price. Not applicable for `Option` markets
  - `minQuantityLimit` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `maxQuantityLimit` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `timeZone` string, required: time zone
  - `tickSize` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `liquidityTickSize` string, required: liquidity tick size. Not applicable for `Option` markets
  - `liquidityPrecision` integer, required: liquidity precision. Not applicable for `Option` markets
  - `roundingCorrectionFactor` string, required: rounding correction factor for market
  - `makerMinLiquidityAddition` string, required: minimum amount required to invest liquidity to market. Not applicable for `Option` markets
  - `orderTypes` OrderTypeAsString[]
  - `spotTradingEnabled` boolean, required: spot trading enabled (only applies for Spot markets)
  - `marginTradingEnabled` boolean, required: margin trading enabled (only applies for Spot markets)
  - `marketEnabled` boolean, required: market enabled
  - `createOrderEnabled` boolean, required: able to create order. Always `false` while the exchange is halted.
  - `amendOrderEnabled` boolean: able to amend order. Always `false` while the exchange is halted.
  - `cancelOrderEnabled` boolean, required: able to cancel order. `false` while the exchange is halted, unless cancellation remains a permitted action (see the `allow` field of `GET /v1/status`).
  - `liquidityInvestEnabled` boolean, required: able to invest liquidity to market. Not applicable for `Option` markets. `false` while the exchange is halted, unless liquidity investment remains a permitted action (see the `allow` field of `GET /v1/status`).
  - `liquidityWithdrawEnabled` boolean, required: able to withdraw liquidity from market. Not applicable for `Option` markets. `false` while the exchange is halted, unless liquidity withdrawal remains a permitted action (see the `allow` field of `GET /v1/status`).
  - `feeGroupId` integer, required: Identifier to the trade fee assigned to this market. Used with `tradeFeeRate` at [Get Trading Account](/rest/api/get-trading-account-by-id)
  - `feeTiers` FeeTier[], required: all available fee tiers. Not applicable for `Option` markets
    - `feeTierId` string, required: unique fee tier ID, see [Get Market By Symbol](/rest/api/get-market-by-symbol)
    - `staticSpreadFee` string, required: static spread fee
    - `isDislocationEnabled` boolean, required: dislocation enabled/disabled
  - `marketType` 'SPOT' | 'PERPETUAL' | 'DATED_FUTURE' | 'OPTION', required: market type can have the following string values `"SPOT"`, `"PERPETUAL"`, `"DATED_FUTURE"`, `"OPTION"`
  - `contractMultiplier` integer: contract multiplier. (only applies to perpetual market)
  - `settlementAssetSymbol` string: settlement asset symbol. (only applies to perpetual market)
  - `openInterestUSD` string, required: cumulative notional value of all open interest for a specific derivative contract on the exchange.
  - `concentrationRiskThresholdUSD` string, required: open interest notional of an account for a specific derivative contract.
  - `concentrationRiskPercentage` string, required: percentage of the total open interest for a specific derivative contract.
  - `expiryDatetime` string, required: denotes the time when the market expires in ISO 8601 with millisecond format as string
  - `optionStrikePrice` string: The price at which the option can be exercised upon expiry.
  - `optionType` 'CALL' | 'PUT': Type of Option market
  - `premiumCapRatio` string: A cap that is set on the underlying asset's movement as part of the premium that limits the option buyer's profit.
  - `auctionEnabled` boolean: whether auction is enabled for this market
  - `auctionPriceCollar` string: auction clearing price range from Index Price, expressed as a decimal ratio

## Other responses

- `404`: 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)