---
title: "Get Markets"
method: GET
path: "/v1/markets"
tags: ["market-data"]
---

# Get Markets

`GET /v1/markets`

## Request

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

Get 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)