跳到主要内容

行情接口

[行情接口]模块下的API接口不需要身份验证。

获取服务器时间

请求示例

curl "https://contract.mexc.com/api/v1/contract/ping"

响应示例

{
"success": true,
"code": 0,
"data": 1761875313209
}
  • GET api/v1/contract/ping

请求参数:

获取合约信息

请求示例

curl "https://contract.mexc.com/api/v1/contract/detail"

响应示例

{
"success": true,
"code": 0,
"data": {
"symbol": "BTC_USDT",
"displayName": "BTC_USDT永续",
"displayNameEn": "BTC_USDT PERPETUAL",
"positionOpenType": 3,
"baseCoin": "BTC",
"quoteCoin": "USDT",
"baseCoinName": "BTC",
"quoteCoinName": "USDT",
"futureType": 1,
"settleCoin": "USDT",
"contractSize": 0.0001,
"minLeverage": 1,
"maxLeverage": 500,
"countryConfigContractMaxLeverage": 0,
"priceScale": 1,
"volScale": 0,
"amountScale": 4,
"priceUnit": 0.1,
"volUnit": 1,
"minVol": 1,
"maxVol": 400000,
"bidLimitPriceRate": 0.1,
"askLimitPriceRate": 0.1,
"takerFeeRate": 0.0004,
"makerFeeRate": 0.0001,
"maintenanceMarginRate": 0.001,
"initialMarginRate": 0.002,
"riskBaseVol": 4500000,
"riskIncrVol": 0,
"riskLongShortSwitch": 0,
"riskIncrMmr": 0,
"riskIncrImr": 0,
"riskLevelLimit": 1,
"priceCoefficientVariation": 0.004,
"indexOrigin": [
"BITGET",
"BYBIT",
"BINANCE",
"HTX",
"OKX",
"MEXC",
"KUCOIN"
],
"state": 0,
"isNew": false,
"isHot": false,
"isHidden": false,
"conceptPlate": [
"mc-trade-zone-pow"
],
"conceptPlateId": [
12
],
"riskLimitType": "BY_VOLUME",
"maxNumOrders": [
200,
50
],
"marketOrderMaxLevel": 20,
"marketOrderPriceLimitRate1": 0.2,
"marketOrderPriceLimitRate2": 0.005,
"triggerProtect": 0.1,
"appraisal": 0,
"showAppraisalCountdown": 0,
"automaticDelivery": 0,
"apiAllowed": false,
"depthStepList": [
"0.1",
"1",
"10",
"100"
],
"limitMaxVol": 2500000,
"threshold": 0,
"baseCoinIconUrl": "https://public.mocortech.com/coin/F20250612182226438Ba037qttKoGcrm.png",
"id": 10,
"vid": "128f589271cb4951b03e71e6323eb7be",
"baseCoinId": "febc9973be4d4d53bb374476239eb219",
"createTime": 1591242684000,
"openingTime": 0,
"openingCountdownOption": 1,
"showBeforeOpen": true,
"isMaxLeverage": true,
"isZeroFeeRate": true,
"riskLimitMode": "CUSTOM",
"isZeroFeeSymbol": true,
"riskLimitCustom": [
{
"level": 1,
"maxVol": 50000,
"mmr": 0.001,
"imr": 0.002,
"maxLeverage": 500
},
{
"level": 2,
"maxVol": 60000,
"mmr": 0.004,
"imr": 0.005,
"maxLeverage": 200
},
{
"level": 3,
"maxVol": 250000,
"mmr": 0.005,
"imr": 0.01,
"maxLeverage": 100
},
{
"level": 4,
"maxVol": 1200000,
"mmr": 0.01,
"imr": 0.02,
"maxLeverage": 50
},
{
"level": 5,
"maxVol": 3000000,
"mmr": 0.02,
"imr": 0.05,
"maxLeverage": 20
},
{
"level": 6,
"maxVol": 4500000,
"mmr": 0.05,
"imr": 0.1,
"maxLeverage": 10
}
],
"liquidationFeeRate": 0.0004,
"feeRateMode": "TIERED",
"leverageFeeRates": [],
"tieredFeeRates": [
{
"takerFeeRate": 0,
"makerFeeRate": 0,
"minTieredDealAmount": 0,
"maxTieredDealAmount": 10000000
},
{
"takerFeeRate": 0.0004,
"makerFeeRate": 0.0001,
"minTieredDealAmount": 10000001
}
],
"tieredDealAmount": 0,
"tieredEffectiveDay": 0,
"tieredAppointContract": true,
"tieredExcludeContractId": true,
"tieredContractIds": [
10,
77,
1104
],
"tieredExcludeZeroFee": false,
"type": 1,
"stopOnlyFair": false,
"statisticType": "FIXED",
"fixedStartTime": 1760544000000,
"fixedEndTime": 1763049600000
}
}
  • GET api/v1/contract/detail

请求参数:

参数名类型是否必填说明
symbolstringfalse合约名

响应参数:

参数名类型说明
symbolstring合约名
displayNamestring展示名
displayNameEnstring英文展示名
positionOpenTypeint开仓类型,1:逐仓,2:全仓,3:全仓,逐仓都支持
baseCoinstring标的货币 如 BTC
quoteCoinstring标价货币 如 USDT
settleCoinstring结算货币 如 USDT
contractSizedecimal合约面值
minLeverageint杠杆倍数下限
maxLeverageint杠杆倍数上限
priceScaleint价格精度
volScaleint数量精度
amountScaleint金额精度
priceUnitint价格的最小步进单位
volUnitint数量的最小步进单位
minVoldecimal订单张数下限
maxVoldecimal订单张数上限
bidLimitPriceRatedecimal买单价格限制比率
askLimitPriceRatedecimal卖单价格限制比率
takerFeeRatedecimal吃单费率
makerFeeRatedecimal挂单费率
maintenanceMarginRatedecimal维持保证金率
initialMarginRatedecimal初始保证金率
riskBaseVoldecimal基本张数
riskIncrVoldecimal递增张数
riskLongShortSwitchint多、空风险限额是否独立开关;0-未开启;1-开启
riskBaseVolLongdecimal基本张数-多方向
riskIncrVolLongdecimal递增张数-多方向
riskBaseVolShortdecimal基本张数-空方向
riskIncrVolShortdecimal递增张数-空方向
riskIncrMmrdecimal维持保证金率递增量
riskIncrImrdecimal初始保证金率递增量
riskLevelLimitint风险限额档位数
priceCoefficientVariationdecimal合理价格偏离指数价格系数
indexOriginList<String>指数来源
stateint状态,0:启用,1:交割,2:交割完成,3:下线,4: 暂停
apiAllowedboolean是否支持api交易
conceptPlateList<String>归属板块,与板块列表entryKey字段对应
riskLimitTypestring风险限额类型,BY_VOLUME: 按张数 ,BY_VALUE:按仓位价值
maxNumOrdersList<Integer>最大挂单数:[双向向持仓最大挂单数,单向持仓最大挂单数]
typeinttype币对类型,1普通,2停盘类。默认是1普通类

获取可划转币种

请求示例

curl "https://contract.mexc.com/api/v1/contract/support_currencies"

响应示例

{
"success": true,
"code": 0,
"data": [
"STETH",
"MXSOL",
"CRV",
"USDT",
"DOGE",
"ATOM",
"WBTC",
"CHZ",
"XRP",
"XLM",
"LINK",
"TRX",
"BSV",
"BCH",
"SUI",
"DOT",
"FIL",
"MX",
"BTC",
"WLFI",
"SOL",
"AVAX",
"ETC",
"BNB",
"ETH",
"USDE",
"LTC",
"USDC",
"ADA"
]
}
  • GET api/v1/contract/support_currencies

请求参数:

响应参数:

返回的"data"对象是一个字符串数组,每一个字符串代表一个支持的币种。

获取合约深度信息

请求示例

curl "https://contract.mexc.com/api/v1/contract/depth/BTC_USDT"

响应示例

{
"success": true,
"code": 0,
"data": {
"asks": [
[
108779.2,
3240,
1
],
[
108779.3,
3884,
1
]
],
"bids": [
[
108779.1,
3240,
1
],
[
108779,
3884,
1
]
],
"version": 28111438870,
"timestamp": 1761879567135
}
}
  • GET api/v1/contract/depth/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名

响应参数:

参数名类型说明
asksList<Numeric[]>卖方深度
bidsList<Numeric[]>买方深度
versionlong版本号
timestamplong系统时间戳

备注: [411.8, 10, 1] 411.8为价格,10为此价格的合约张数,1为订单数量

获取合约最近N条深度信息快照

请求示例

curl "https://contract.mexc.com/api/v1/contract/depth_commits/BTC_USDT/20"

响应示例

{
"success": true,
"code": 0,
"data": [
{
"asks": [],
"bids": [
[
3818.91,
272,
1
]
],
"version": 26457599299
},
{
"asks": [],
"bids": [
[
3818.89,
1524,
3
]
],
"version": 26457599298
},
{
"asks": [],
"bids": [
[
3818.89,
1123,
2
]
],
"version": 26457599297
},
{
"asks": [],
"bids": [
[
3818.87,
788,
1
]
],
"version": 26457599296
},
{
"asks": [],
"bids": [
[
3818.88,
886,
1
]
],
"version": 26457599295
}
]
}
  • GET api/v1/contract/depth_commits/{symbol}/{limit}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
limitinttrue条数

响应参数:

参数名类型说明
asksList<Numeric[]>卖方深度
bidsList<Numeric[]>买方深度
versionlong版本号

获取合约指数价格

请求示例

curl "https://contract.mexc.com/api/v1/contract/index_price/BTC_USDT"

响应示例

{
"success": true,
"code": 0,
"data": {
"symbol": "BTC_USDT",
"indexPrice": 31103.4,
"timestamp": 1609829705178
}
}
  • GET api/v1/contract/index_price/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名

响应参数:

参数名类型说明
symbolstring交易对
indexPricedecimal指数价格
timestamplong系统时间戳

获取合约合理价格

请求示例

curl "https://contract.mexc.com/api/v1/contract/fair_price/BTC_USDT"

响应示例

{
"success": true,
"code": 0,
"data": {
"symbol": "BTC_USDT",
"fairPrice": 31103.4,
"timestamp": 1609829705178
}
}
  • GET api/v1/contract/fair_price/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名

响应参数:

参数名类型说明
symbolstring合约名
fairPricedecimal合理价格
timestamplong系统时间戳

获取合约资金费率

请求示例

curl "https://contract.mexc.com/api/v1/contract/funding_rate/BTC_USDT"

响应示例

{
"success": true,
"code": 0,
"data": {
"symbol": "BTC_USDT",
"fundingRate": 0.000018,
"maxFundingRate": 0.0018,
"minFundingRate": -0.0018,
"collectCycle": 8,
"nextSettleTime": 1761897600000,
"timestamp": 1761879755894
}
}
  • GET api/v1/contract/funding_rate/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名

响应参数:

参数名类型说明
symbolstring合约名
fundingRatedecimal资金费率
maxFundingRatedecimal资金费率上限
minFundingRatedecimal资金费率下限
collectCycleint收取周期
nextSettleTimelong下次收取时间
timestamplong系统时间戳

获取蜡烛图数据

请求示例

curl "https://contract.mexc.com/api/v1/contract/kline/BTC_USDT?interval=Min15&start=1609992674&end=1610113500"

响应示例

{
"success": true,
"code": 0,
"data": {
"time": [
1761876000,
1761876900,
1761877800,
1761878700,
1761879600
],
"open": [
109573.9,
109006.4,
109301.5,
108725.9,
108794.7
],
"close": [
109006.4,
109301.5,
108725.9,
108794.7,
108669.9
],
"high": [
109628.1,
109426.2,
109350.2,
108913.8,
108815.1
],
"low": [
108953.3,
109006.4,
108666.2,
108498.5,
108649.0
],
"vol": [
5587051.0,
5739575.0,
5945477.0,
5863529.0,
1668892.0
],
"amount": [
6.106243567181E7,
6.270099147368E7,
6.47966331717E7,
6.374986900458E7,
1.814907510911E7
],
"realOpen": [
109574.0,
109010.0,
109301.4,
108726.0,
108794.8
],
"realClose": [
109006.4,
109301.5,
108725.9,
108794.7,
108669.9
],
"realHigh": [
109628.1,
109426.2,
109350.2,
108913.8,
108815.1
],
"realLow": [
108953.3,
109010.0,
108666.2,
108498.5,
108649.0
]
}
}
  • GET api/v1/contract/kline/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
intervalstringfalse间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1
startlongfalse开始时间戳,单位秒
endlongfalse结束时间戳,单位秒

响应参数:

参数名类型说明
opendouble开盘价
closedouble收盘价
highdouble最高价
lowdouble最低价
voldouble成交量
timelong时间窗口

注意:

1、单次请求的最大数据量是2000。如果您选择的开始/结束时间和时间粒度导致超过单次请求的最大数据量,您的请求将只会返回2000个数据。如果您希望在更大的时间范围内获取足够精细的数据,则需要使用多个开始/结束范围进行多次请求。

2、如果只提供了开始时间,则查询开始时间到系统当前时间的数据。如果只提供了结束时间,则返回离结束时间最近的2000条数据。如果开始时间和结束时间均未提供,则查询离系统当前时间最近的2000条数据。

获取指数价格蜡烛图数据

请求示例

curl "https://contract.mexc.com/api/v1/contract/kline/index_price/BTC_USDT?interval=Min15&start=1609992674&end=1610113500"

响应示例

{
"success": true,
"code": 0,
"data": {
"time": [
1761876000,
1761876900,
1761877800,
1761878700,
1761879600
],
"open": [
109620.6,
109057.0,
109358.4,
108788.3,
108857.6
],
"close": [
109057.0,
109358.4,
108788.3,
108857.6,
108628.4
],
"high": [
109685.6,
109474.8,
109408.0,
108963.7,
108872.3
],
"low": [
109013.6,
109057.0,
108745.9,
108564.5,
108622.8
],
"vol": [
0.0,
0.0,
0.0,
0.0,
0.0
],
"amount": [
0.0,
0.0,
0.0,
0.0,
0.0
],
"realOpen": [
109057.0,
109358.4,
108788.3,
108857.6,
108628.4
],
"realClose": [
109057.0,
109358.4,
108788.3,
108857.6,
108628.4
],
"realHigh": [
109057.0,
109358.4,
108788.3,
108857.6,
108628.4
],
"realLow": [
109057.0,
109358.4,
108788.3,
108857.6,
108628.4
]
}
}
  • GET api/v1/contract/kline/index_price/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
intervalstringfalse间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1
startlongfalse开始时间戳,单位秒
endlongfalse结束时间戳,单位秒

响应参数:

参数名类型说明
opendouble开盘价
closedouble收盘价
highdouble最高价
lowdouble最低价
voldouble成交量
timelong时间窗口

注意: 1、单次请求的最大数据量是2000。如果您选择的开始/结束时间和时间粒度导致超过单次请求的最大数据量,您的请求将只会返回2000个数据。如果您希望在更大的时间范围内获取足够精细的数据,则需要使用多个开始/结束范围进行多次请求。

2、如果只提供了开始时间,则查询开始时间到系统当前时间的数据。如果只提供了结束时间,则返回离结束时间最近的2000条数据。如果开始时间和结束时间均未提供,则查询离系统当前时间最近的2000条数据。

获取合理价格蜡烛图数据

请求示例

curl "https://contract.mexc.com/api/v1/contract/kline/fair_price/BTC_USDT?interval=Min15&start=1609992674&end=1610113500"

响应示例

{
"success": true,
"code": 0,
"data": {
"time": [
1761876000,
1761876900,
1761877800,
1761878700,
1761879600
],
"open": [
109573.9,
109003.9,
109304.4,
108726.1,
108794.9
],
"close": [
109003.9,
109304.4,
108726.1,
108794.9,
108629.1
],
"high": [
109631.6,
109421.8,
109353.0,
108904.4,
108810.6
],
"low": [
108960.4,
109003.9,
108681.1,
108500.3,
108555.6
],
"vol": [
0.0,
0.0,
0.0,
0.0,
0.0
],
"amount": [
0.0,
0.0,
0.0,
0.0,
0.0
],
"realOpen": [
109003.9,
109304.4,
108726.1,
108794.9,
108629.1
],
"realClose": [
109003.9,
109304.4,
108726.1,
108794.9,
108629.1
],
"realHigh": [
109003.9,
109304.4,
108726.1,
108794.9,
108629.1
],
"realLow": [
109003.9,
109304.4,
108726.1,
108794.9,
108629.1
]
}
}
  • GET api/v1/contract/kline/fair_price/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
intervalstringfalse间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1
startlongfalse开始时间戳,单位秒
endlongfalse结束时间戳,单位秒

响应参数:

参数名类型说明
opendouble开盘价
closedouble收盘价
highdouble最高价
lowdouble最低价
voldouble成交量
timelong时间窗口

注意: 1、单次请求的最大数据量是2000。如果您选择的开始/结束时间和时间粒度导致超过单次请求的最大数据量,您的请求将只会返回2000个数据。如果您希望在更大的时间范围内获取足够精细的数据,则需要使用多个开始/结束范围进行多次请求。

2、如果只提供了开始时间,则查询开始时间到系统当前时间的数据。如果只提供了结束时间,则返回离结束时间最近的2000条数据。如果开始时间和结束时间均未提供,则查询离系统当前时间最近的2000条数据。

获取成交数据

请求示例

curl "https://contract.mexc.com/api/v1/contract/deals/BTC_USDT"

响应示例

{
"success": true,
"code": 0,
"data": [
{
"p": 109177.4,
"v": 14,
"T": 1,
"O": 1,
"M": 2,
"t": 1761883066648
},
{
"p": 109177.4,
"v": 12,
"T": 1,
"O": 1,
"M": 2,
"t": 1761883066624
}
]
}
  • GET api/v1/contract/deals/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
limitintfalse结果集数量,最大为100,不填默认返回100条

响应参数:

参数名类型说明
pdecimal成交价
vdecimal数量
Tint成交方向,1:买,2:卖
Oint是否是开仓,1:taker和maker都是开仓,2:taker和maker都不是开仓,3:其他情况,当O为1的时候, vol是新增的持仓量
Mint是否为自成交,1:是,2:否
tlong成交时间

获取合约行情数据

请求示例

curl "https://contract.mexc.com/api/v1/contract/ticker"

响应示例

{
"success": true,
"code": 0,
"data": {
"contractId": 10,
"symbol": "BTC_USDT",
"lastPrice": 109167.1,
"bid1": 109167,
"ask1": 109167.1,
"volume24": 954830625,
"amount24": 10374579341.00211,
"holdVol": 381485808,
"lower24Price": 106226,
"high24Price": 111553.8,
"riseFallRate": 0.014,
"riseFallValue": 1510.6,
"indexPrice": 109235,
"fairPrice": 109168.9,
"fundingRate": 0,
"maxBidPrice": 120158.5,
"minAskPrice": 98311.5,
"timestamp": 1761883095759,
"riseFallRates": {
"zone": "UTC+8",
"r": 0.014,
"v": 1510.6,
"r7": -0.0061,
"r30": -0.0343,
"r90": -0.0532,
"r180": 0.1329,
"r365": 0.5149
},
"riseFallRatesOfTimezone": [
-0.0157,
0.0083,
0.014
]
}
}
  • GET api/v1/contract/ticker

请求参数:

参数名类型是否必填说明
symbolstringfalse合约名

响应参数:

参数名类型说明
symbolstring合约名
lastPricedecimal最新价
bid1decimal买一价
ask1decimal卖一价
volume24decimal24小时成交量,按张数统计
amount24decimal24小时成交额
holdVoldecimal总持仓量
lower24Pricedecimal24小时最低价
high24Pricedecimal24小时内最高价
riseFallRatedecimal涨跌幅
riseFallValuedecimal涨跌额
indexPricedecimal指数价格
fairPricedecimal合理价
fundingRatedecimal资金费率
timestamplong成交时间

获取合约风险基金余额

请求示例

curl "https://contract.mexc.com/api/v1/contract/risk_reverse"

响应示例

{
"success": true,
"code": 0,
"data": [
{
"symbol": "BTC_USDT",
"currency": "USDT",
"available": 97284530.448634083318792525314410007362,
"timestamp": 1761883124789
}
]
}
  • GET api/v1/contract/risk_reverse/{symbol}

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名

响应参数:

参数名类型说明
symbolstring合约名
currencystring结算货币
availabledecimal余额
timestamplong系统时间戳

获取合约风险基金余额历史

请求示例

curl "https://contract.mexc.com/api/v1/contract/risk_reverse/history?symbol=BTC_USDT&page_num=1&page_size=20"

响应示例

{
"success": true,
"code": 0,
"data": {
"pageSize": 3,
"totalCount": 42,
"totalPage": 14,
"currentPage": 1,
"resultList": [
{
"symbol": "BTC_USDT",
"currency": "USDT",
"available": 97284530.448634083318792525314410007362,
"snapshotTime": 1761883200000
},
{
"symbol": "BTC_USDT",
"currency": "USDT",
"available": 97278356.693307391915362536014224404257,
"snapshotTime": 1761868800000
},
{
"symbol": "BTC_USDT",
"currency": "USDT",
"available": 97275052.998679590630831496951543806325,
"snapshotTime": 1761854400000
}
]
}
}
  • GET api/v1/contract/risk_reverse/history

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
page_numinttrue当前页数,默认为1
page_sizeinttrue每页大小,默认20,最大100

响应参数:

参数名类型说明
pageSizeint页面大小
totalCountint总条数
totalPageint总页数
currentPageint当前页
resultListlist数据结果集
symbolstring合约名
currencystring结算货币
availabledecimal余额
snapshotTimelong快照时间

获取合约资金费率历史

请求示例

curl "https://contract.mexc.com/api/v1/contract/funding_rate/history?symbol=BTC_USDT&page_num=1&page_size=20"

响应示例

{
"success": true,
"code": 0,
"data": {
"pageSize": 3,
"totalCount": 1619,
"totalPage": 540,
"currentPage": 1,
"resultList": [
{
"symbol": "BTC_USDT",
"fundingRate": 0.000021,
"settleTime": 1761868800000,
"collectCycle": 8
},
{
"symbol": "BTC_USDT",
"fundingRate": 0.000032,
"settleTime": 1761840000000,
"collectCycle": 8
},
{
"symbol": "BTC_USDT",
"fundingRate": -0.000001,
"settleTime": 1761811200000,
"collectCycle": 8
}
]
}
}
  • GET api/v1/contract/funding_rate/history

请求参数:

参数名类型是否必填说明
symbolstringtrue合约名
page_numinttrue当前页数,默认为1
page_sizeinttrue每页大小,默认20,最大1000

响应参数:

参数名类型说明
pageSizeint页面大小
totalCountint总条数
totalPageint总页数
currentPageint当前页
resultListlist数据结果集
symbolstring合约名
fundingRatedecimal资金费率
settleTimelong结算时间
collectCycleint资金费率周期(小时)