行情接口
[行情接口]模块下的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
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | false | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 合约名 |
| displayName | string | 展示名 |
| displayNameEn | string | 英文展示名 |
| positionOpenType | int | 开仓类型,1:逐仓,2:全仓,3:全仓,逐仓都支持 |
| baseCoin | string | 标的货币 如 BTC |
| quoteCoin | string | 标价货币 如 USDT |
| settleCoin | string | 结算货币 如 USDT |
| contractSize | decimal | 合约面值 |
| minLeverage | int | 杠杆倍数下限 |
| maxLeverage | int | 杠杆倍数上限 |
| priceScale | int | 价格精度 |
| volScale | int | 数量精度 |
| amountScale | int | 金额精度 |
| priceUnit | int | 价格的最小步进单位 |
| volUnit | int | 数量的最小步进单位 |
| minVol | decimal | 订单张数下限 |
| maxVol | decimal | 订单张数上限 |
| bidLimitPriceRate | decimal | 买单价格限制比率 |
| askLimitPriceRate | decimal | 卖单价格限制比率 |
| takerFeeRate | decimal | 吃单费率 |
| makerFeeRate | decimal | 挂单费率 |
| maintenanceMarginRate | decimal | 维持保证金率 |
| initialMarginRate | decimal | 初始保证金率 |
| riskBaseVol | decimal | 基本张数 |
| riskIncrVol | decimal | 递增张数 |
| riskLongShortSwitch | int | 多、空风险限额是否独立开关;0-未开启;1-开启 |
| riskBaseVolLong | decimal | 基本张数-多方向 |
| riskIncrVolLong | decimal | 递增张数-多方向 |
| riskBaseVolShort | decimal | 基本张数-空方向 |
| riskIncrVolShort | decimal | 递增张数-空方向 |
| riskIncrMmr | decimal | 维持保证金率递增量 |
| riskIncrImr | decimal | 初始保证金率递增量 |
| riskLevelLimit | int | 风险限额档位数 |
| priceCoefficientVariation | decimal | 合理价格偏离指数价格系数 |
| indexOrigin | List<String> | 指数来源 |
| state | int | 状态,0:启用,1:交割,2:交割完成,3:下线,4: 暂停 |
| apiAllowed | boolean | 是否支持api交易 |
| conceptPlate | List<String> | 归属板块,与板块列表entryKey字段对应 |
| riskLimitType | string | 风险限额类型,BY_VOLUME: 按张数 ,BY_VALUE:按仓位价值 |
| maxNumOrders | List<Integer> | 最大挂单数:[双向向持仓最大挂单数,单向持仓最大挂单数] |
| type | int | type币对类型,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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| asks | List<Numeric[]> | 卖方深度 |
| bids | List<Numeric[]> | 买方深度 |
| version | long | 版本号 |
| timestamp | long | 系统时间戳 |
备注: [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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| limit | int | true | 条数 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| asks | List<Numeric[]> | 卖方深度 |
| bids | List<Numeric[]> | 买方深度 |
| version | long | 版本号 |
获取合约指数价格
请求示例
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 交易对 |
| indexPrice | decimal | 指数价格 |
| timestamp | long | 系统时间戳 |
获取合约合理价格
请求示例
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 合约名 |
| fairPrice | decimal | 合理价格 |
| timestamp | long | 系统时间戳 |
获取合约资金费率
请求示例
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 合约名 |
| fundingRate | decimal | 资金费率 |
| maxFundingRate | decimal | 资金费率上限 |
| minFundingRate | decimal | 资金费率下限 |
| collectCycle | int | 收取周期 |
| nextSettleTime | long | 下次收取时间 |
| timestamp | long | 系统时间戳 |
获取蜡烛图数据
请求示例
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| interval | string | false | 间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1 |
| start | long | false | 开始时间戳,单位秒 |
| end | long | false | 结束时间戳,单位秒 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| open | double | 开盘价 |
| close | double | 收盘价 |
| high | double | 最高价 |
| low | double | 最低价 |
| vol | double | 成交量 |
| time | long | 时间窗口 |
注意:
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| interval | string | false | 间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1 |
| start | long | false | 开始时间戳,单位秒 |
| end | long | false | 结束时间戳,单位秒 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| open | double | 开盘价 |
| close | double | 收盘价 |
| high | double | 最高价 |
| low | double | 最低价 |
| vol | double | 成交量 |
| time | long | 时间窗口 |
注意: 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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| interval | string | false | 间隔: Min1、Min5、Min15、Min30、Min60、Hour4、Hour8、Day1、Week1、Month1,不填时默认Min1 |
| start | long | false | 开始时间戳,单位秒 |
| end | long | false | 结束时间戳,单位秒 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| open | double | 开盘价 |
| close | double | 收盘价 |
| high | double | 最高价 |
| low | double | 最低价 |
| vol | double | 成交量 |
| time | long | 时间窗口 |
注意: 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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| limit | int | false | 结果集数量,最大为100,不填默认返回100条 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| p | decimal | 成交价 |
| v | decimal | 数量 |
| T | int | 成交方向,1:买,2:卖 |
| O | int | 是否是开仓,1:taker和maker都是开仓,2:taker和maker都不是开仓,3:其他情况,当O为1的时候, vol是新增的持仓量 |
| M | int | 是否为自成交,1:是,2:否 |
| t | long | 成交时间 |
获取合约行情数据
请求示例
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
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | false | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 合约名 |
| lastPrice | decimal | 最新价 |
| bid1 | decimal | 买一价 |
| ask1 | decimal | 卖一价 |
| volume24 | decimal | 24小时成交量,按张数统计 |
| amount24 | decimal | 24小时成交额 |
| holdVol | decimal | 总持仓量 |
| lower24Price | decimal | 24小时最低价 |
| high24Price | decimal | 24小时内最高价 |
| riseFallRate | decimal | 涨跌幅 |
| riseFallValue | decimal | 涨跌额 |
| indexPrice | decimal | 指数价格 |
| fairPrice | decimal | 合理价 |
| fundingRate | decimal | 资金费率 |
| timestamp | long | 成交时间 |
获取合约风险基金余额
请求示例
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}
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| symbol | string | 合约名 |
| currency | string | 结算货币 |
| available | decimal | 余额 |
| timestamp | long | 系统时间戳 |
获取合约风险基金余额历史
请求示例
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
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| page_num | int | true | 当前页数,默认为1 |
| page_size | int | true | 每页大小,默认20,最大100 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| pageSize | int | 页面大小 |
| totalCount | int | 总条数 |
| totalPage | int | 总页数 |
| currentPage | int | 当前页 |
| resultList | list | 数据结果集 |
| symbol | string | 合约名 |
| currency | string | 结算货币 |
| available | decimal | 余额 |
| snapshotTime | long | 快照时间 |
获取合约资金费率历史
请求示例
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
请求参数:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | string | true | 合约名 |
| page_num | int | true | 当前页数,默认为1 |
| page_size | int | true | 每页大小,默认20,最大1000 |
响应参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| pageSize | int | 页面大小 |
| totalCount | int | 总条数 |
| totalPage | int | 总页数 |
| currentPage | int | 当前页 |
| resultList | list | 数据结果集 |
| symbol | string | 合约名 |
| fundingRate | decimal | 资金费率 |
| settleTime | long | 结算时间 |
| collectCycle | int | 资金费率周期(小时) |