Get Symbol Detail

Submit request to get info of the specified contract.

HTTP REQUEST

GET /api/v1/contracts/{symbol}

Example

GET /api/v1/contracts/XBTUSDM

{
    "code": "200000",
    "data": {
        "symbol": "XBTUSDTM",
        "rootSymbol": "USDT",
        "type": "FFWCSX",
        "firstOpenDate": 1585555200000,
        "expireDate": null,
        "settleDate": null,
        "baseCurrency": "XBT",
        "quoteCurrency": "USDT",
        "settleCurrency": "USDT",
        "maxOrderQty": 1000000,
        "maxPrice": 1000000.0,
        "lotSize": 1,
        "tickSize": 0.1,
        "indexPriceTickSize": 0.01,
        "multiplier": 0.001,
        "initialMargin": 0.008,
        "maintainMargin": 0.004,
        "maxRiskLimit": 100000,
        "minRiskLimit": 100000,
        "riskStep": 50000,
        "makerFeeRate": 2.0E-4,
        "takerFeeRate": 6.0E-4,
        "takerFixFee": 0.0,
        "makerFixFee": 0.0,
        "settlementFee": null,
        "isDeleverage": true,
        "isQuanto": true,
        "isInverse": false,
        "markMethod": "FairPrice",
        "fairMethod": "FundingRate",
        "fundingBaseSymbol": ".XBTINT8H",
        "fundingQuoteSymbol": ".USDTINT8H",
        "fundingRateSymbol": ".XBTUSDTMFPI8H",
        "indexSymbol": ".KXBTUSDT",
        "settlementSymbol": "",
        "status": "Open",
        "fundingFeeRate": 6.41E-4,
        "predictedFundingFeeRate": 5.5E-5,
        "fundingRateGranularity": 28800000,
        "openInterest": "6273644",
        "turnoverOf24h": 1.9110000807101517E9,
        "volumeOf24h": 21807.101,
        "markPrice": 87351.75,
        "indexPrice": 87357.57,
        "lastTradePrice": 87319.4,
        "nextFundingRateTime": 1816952,
        "maxLeverage": 125,
        "sourceExchanges": [
            "okex",
            "binance",
            "kucoin",
            "bybit",
            "bitmart",
            "gateio"
        ],
        "premiumsSymbol1M": ".XBTUSDTMPI",
        "premiumsSymbol8H": ".XBTUSDTMPI8H",
        "fundingBaseSymbol1M": ".XBTINT",
        "fundingQuoteSymbol1M": ".USDTINT",
        "lowPrice": 85201.8,
        "highPrice": 90000.0,
        "priceChgPct": -0.0033,
        "priceChg": -291.0,
        "k": 490.0,
        "m": 300.0,
        "f": 1.3,
        "mmrLimit": 0.3,
        "mmrLevConstant": 125.0,
        "supportCross": true,
        "buyLimit": 91717.92,
        "sellLimit": 82982.88
    }
}

REQUEST URL

This endpoint support Futures URL

REQUEST RATE LIMIT

Public weight：3

PARAMETERS

Param	Type	Mandatory	Description
symbol	String	Yes	Path Parameter. Symbol of the contract

RESPONSES

Param	Description
symbol	Contract status
rootSymbol	Contract group
type	Type of the contract
firstOpenDate	First Open Date
expireDate	Expiration date. Null means it will never expire
settleDate	Settlement date. Null indicates that automatic settlement is not supported
baseCurrency	Base currency
quoteCurrency	Quote currency
settleCurrency	Currency used to clear and settle the trades
maxOrderQty	Maximum order quantity
maxPrice	Maximum order price
lotSize	Minimum contract quantity: The smallest unit for contracts is lots. The order quantity must be in lots and cannot be smaller than the minimum contract quantity (lotSize) or larger than the maximum order quantity (maxOrderQty). The order quantity must be an integer multiple of lotSize; otherwise, the system will report an error. The order quantity represents the number of contracts to buy or sell. For example, for the XBTUSDTM contract, if the lotSize is 1, the order quantity must be an integer multiple of 1 and cannot be 1.1
tickSize	Minimum price fluctuation: The order price must be a positive integer multiple of the price increment. For example, for the XBTUSDTM contract, if the tickSize is 0.1, the price can be 70000.1 but not 70000.01
indexPriceTickSize	Index price of tick size
multiplier	Contract multiplier: The basic unit for contract APIs is lots, with the value of each lot represented in the base currency. Refer to this field to understand the quantity of base currency per lot. For example, for the XBTUSDTM contract, if the multiplier is 0.001, each XBTUSDTM contract is worth 0.001 BTC. For inverse contracts, such as the XBTUSDM contract, each lot corresponds to 1 USD
initialMargin	Initial margin requirement
maintainMargin	Maintenance margin requirement
maxRiskLimit	Maximum risk limit (unit: XBT)
minRiskLimit	Minimum risk limit (unit: XBT)
riskStep	Risk limit increment value (unit: XBT)
makerFeeRate	Maker fees
takerFeeRate	Taker fees
takerFixFee	Fixed taker fees(Deprecated field, no actual use of the value field)
makerFixFee	Fixed maker fees(Deprecated field, no actual use of the value field)
settlementFee	settlement fee
isDeleverage	Enabled ADL or not
isQuanto	Whether quanto or not(Deprecated field, no actual use of the value field)
isInverse	Reverse contract or not
markMethod	Marking method
fairMethod	Fair price marking method
fundingBaseSymbol	Ticker symbol of the based currency
fundingQuoteSymbol	Ticker symbol of the quote currency
fundingRateSymbol	Funding rate symbol
indexSymbol	Index symbol
settlementSymbol	Settlement Symbol
status	Contract status
fundingFeeRate	Funding fee rate
predictedFundingFeeRate	Predicted funding fee rate
openInterest	open interest
turnoverOf24h	turnover of 24 hours
volumeOf24h	volume of 24 hours
markPrice	Mark price
indexPrice	Index price
lastTradePrice	last trade price
nextFundingRateTime	next funding rate time
maxLeverage	maximum leverage
sourceExchanges	The contract index source exchange
premiumsSymbol1M	Premium index symbol (1 minute)
premiumsSymbol8H	Premium index symbol (8 hours)
fundingBaseSymbol1M	Base currency interest rate symbol (1 minute)
fundingQuoteSymbol1M	Quote currency interest rate symbol (1 minute)
lowPrice	24H Low
highPrice	24H High
priceChgPct	24H Change%
priceChg	24H Change
supportCross	Whether support cross position
buyLimit	Maximum limit buying price
sellLimit	Minimum limit selling price