获取合约信息

限频规则：20次/秒/IP

描述

获取合约详情信息。

HTTP请求

• GET /api/v2/mix/market/contracts

请求示例

curl "https://api.bitget.com/api/v2/mix/market/contracts?productType=usdt-futures&symbol=BTCUSDT"

请求参数

参数名	参数类型	是否必须	描述
symbol	String	否	交易币对
productType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695793701269,
    "data": [
        {
            "symbol": "BTCUSDT",
            "baseCoin": "BTC",
            "quoteCoin": "USDT",
            "buyLimitPriceRatio": "0.9",
            "sellLimitPriceRatio": "0.9",
            "feeRateUpRatio": "0.1",
            "makerFeeRate": "0.0004",
            "takerFeeRate": "0.0006",
            "openCostUpRatio": "0.1",
            "supportMarginCoins": [
                "USDT"
            ],
            "minTradeNum": "0.01",
            "priceEndStep": "1",
            "volumePlace": "2",
            "pricePlace": "1",
            "sizeMultiplier": "0.01",
            "symbolType": "perpetual",
            "minTradeUSDT": "5",
            "maxSymbolOrderNum": "999999",
            "maxProductOrderNum": "999999",
            "maxPositionNum": "150",
            "symbolStatus": "normal",
            "offTime": "-1",
            "limitOpenTime": "-1",
            "deliveryTime": "",
            "deliveryStartTime": "",
            "launchTime": "",
            "fundInterval": "8",
            "minLever": "1",
            "maxLever": "125",
            "posLimit": "0.05",
            "maintainTime": "1680165535278"
        }
    ]
}

返回参数

返回字段	参数类型	字段说明
> symbol	String	产品名称
> baseCoin	String	基础币 如 ETHUSDT 中，特指ETH
> quoteCoin	String	计价币 如 ETHUSDT 中，特指USDT
> buyLimitPriceRatio	String	买价限价比例
> sellLimitPriceRatio	String	卖价限价比例
> feeRateUpRatio	String	手续费上浮比例
> makerFeeRate	String	market手续费率
> takerFeeRate	String	taker手续费率
> openCostUpRatio	String	开仓成本上浮比例
> >supportMarginCoins	List<String>	支持保证金币种
> minTradeNum	String	最小开单数量(基础币)
> priceEndStep	String	价格步长
> volumePlace	String	数量小数位
> pricePlace	String	价格小数位
> sizeMultiplier	String	数量乘数 下单数量要大于 minTradeNum 并且满足 sizeMulti 的倍数
> symbolType	String	合约类型 perpetual 永续 delivery交割
> minTradeUSDT	String	最小USDT交易额
> maxSymbolOrderNum	String	最大持有订单数（symbol维度）
> maxProductOrderNum	String	最大持有订单数（产品类型维度）
> maxPositionNum	String	最大持有仓位数量
> symbolStatus	String	交易对状态 listed 上架 normal 正常/开盘 maintain 禁止交易(禁止开平仓) limit_open 限制下单(可平仓) restrictedAPI API限制下单 off 下架
> offTime	String	下架时间, '-1' 表示正常
> limitOpenTime	String	可开仓时间, '-1' 表示正常; 其它值表示symbol正在/计划维护，指定时间后禁止交易
> deliveryTime	String	交割时间
> deliveryStartTime	String	交割开始时间
> deliveryPeriod	String	交割周期 this_quarter当季 next_quarter次季
> launchTime	String	上架时间
> fundInterval	String	资金费结算周期，每小时/每8小时
> minLever	String	最小杠杆
> maxLever	String	最大杠杆
> posLimit	String	持仓限制
> maintainTime	String	维护时间（状态处于维护/即将维护时会有值）