BUbullish
market-data

Get Historical Market by Symbol

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.

get/v1/history/markets/{symbol}

Request

Response

OK

marketIdstring required
symbolstring required

market symbol. E.g. BTC-USDC-20241004-70000-C for OPTION markets.

baseSymbolstring required

asset symbol as denoted in the world

underlyingBaseSymbolstring

asset symbol as denoted in the world

quoteSymbolstring required

asset symbol as denoted in the world

underlyingQuoteSymbolstring

asset symbol as denoted in the world

quoteAssetIdstring required

unique asset ID

baseAssetIdstring required

unique asset ID

quotePrecisioninteger required

quote precision

basePrecisioninteger required

base precision

pricePrecisioninteger required

number of decimal digits 'after the dot' for price

quantityPrecisioninteger required

number of decimal digits 'after the dot' for quantity

costPrecisioninteger required

number of decimal digits 'after the dot' for cost, price * quantity

priceBufferstring required

buffer range of limit price from the last traded price. Not applicable for Option markets

minQuantityLimitstring required

see asset value format

maxQuantityLimitstring required

see asset value format

timeZonestring required

time zone

tickSizestring required

see asset value format

liquidityTickSizestring required

liquidity tick size. Not applicable for Option markets

liquidityPrecisioninteger required

liquidity precision. Not applicable for Option markets

roundingCorrectionFactorstring required

rounding correction factor for market

makerMinLiquidityAdditionstring required

minimum amount required to invest liquidity to market. Not applicable for Option markets

orderTypesOrderTypeAsString[]
spotTradingEnabledboolean required

spot trading enabled (only applies for Spot markets)

marginTradingEnabledboolean required

margin trading enabled (only applies for Spot markets)

marketEnabledboolean required

market enabled

createOrderEnabledboolean required

able to create order. Always false while the exchange is halted.

amendOrderEnabledboolean

able to amend order. Always false while the exchange is halted.

cancelOrderEnabledboolean 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).

liquidityInvestEnabledboolean 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).

liquidityWithdrawEnabledboolean 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).

feeGroupIdinteger required

Identifier to the trade fee assigned to this market. Used with tradeFeeRate at Get Trading Account

marketType'SPOT' | 'PERPETUAL' | 'DATED_FUTURE' | 'OPTION' required

market type can have the following string values "SPOT", "PERPETUAL", "DATED_FUTURE", "OPTION"

contractMultiplierinteger

contract multiplier. (only applies to perpetual market)

settlementAssetSymbolstring

settlement asset symbol. (only applies to perpetual market)

openInterestUSDstring required

cumulative notional value of all open interest for a specific derivative contract on the exchange.

concentrationRiskThresholdUSDstring required

open interest notional of an account for a specific derivative contract.

concentrationRiskPercentagestring required

percentage of the total open interest for a specific derivative contract.

expiryDatetimestring required

denotes the time when the market expires in ISO 8601 with millisecond format as string

optionStrikePricestring

The price at which the option can be exercised upon expiry.

optionType'CALL' | 'PUT'

Type of Option market

premiumCapRatiostring

A cap that is set on the underlying asset's movement as part of the premium that limits the option buyer's profit.

auctionEnabledboolean

whether auction is enabled for this market

auctionPriceCollarstring

auction clearing price range from Index Price, expressed as a decimal ratio

Example response

{
  "marketId": "10000",
  "symbol": "BTC-USDC-20241004-70000-C",
  "baseSymbol": "BTC",
  "underlyingBaseSymbol": "BTC",
  "quoteSymbol": "BTC",
  "underlyingQuoteSymbol": "BTC",
  "quoteAssetId": "1",
  "baseAssetId": "1",
  "quotePrecision": 4,
  "basePrecision": 8,
  "pricePrecision": 8,
  "quantityPrecision": 8,
  "costPrecision": 8,
  "priceBuffer": "0.3",
  "minQuantityLimit": "1.00000000",
  "maxQuantityLimit": "1.00000000",
  "timeZone": "Etc/UTC",
  "tickSize": "1.00000000",
  "liquidityTickSize": "100.0000",
  "liquidityPrecision": 4,
  "roundingCorrectionFactor": "0.00000001",
  "makerMinLiquidityAddition": "5000",
  "orderTypes": [
    "LMT"
  ],
  "spotTradingEnabled": true,
  "marginTradingEnabled": true,
  "marketEnabled": true,
  "createOrderEnabled": true,
  "amendOrderEnabled": true,
  "cancelOrderEnabled": true,
  "liquidityInvestEnabled": true,
  "liquidityWithdrawEnabled": true,
  "feeGroupId": 1,
  "feeTiers": [
    {
      "feeTierId": "1",
      "staticSpreadFee": "0.00040000",
      "isDislocationEnabled": true
    }
  ],
  "marketType": "SPOT",
  "expiryDatetime": "2024-10-04T08:00:00.000Z",
  "optionStrikePrice": "70000.0000",
  "optionType": "CALL",
  "premiumCapRatio": "0.10",
  "auctionEnabled": true,
  "auctionPriceCollar": "0.05"
}

Changes

No recorded changes to this operation across all 1 revision of this API.