行情接口

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

获取服务器时间

请求示例

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

响应示例

{
  "success": true,
  "data":1587442022003 
}

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 SWAP",
            "positionOpenType":3,
            "baseCoin":"BTC",
            "quoteCoin":"USDT",
            "settleCoin":"USDT",
            "contractSize":0.0001,
            "minLeverage":1,
            "maxLeverage":125,
            "priceScale":2,
            "volScale":0,
            "amountScale":4,
            "priceUnit":0.5,
            "volUnit":1,
            "minVol":1,
            "maxVol":5000000,
            "bidLimitPriceRate":0.03,
            "askLimitPriceRate":0.03,
            "takerFeeRate":0.0006,
            "makerFeeRate":0.0002,
            "maintenanceMarginRate":0.004,
            "initialMarginRate":0.008,
            "riskBaseVol":150000,
            "riskIncrVol":150000,
            "riskIncrMmr":0.004,
            "riskIncrImr":0.004,
            "riskLevelLimit":5,
            "priceCoefficientVariation":0.05,
            "indexOrigin": [
                "Binance",
                "GATEIO",
                "HUOBI",
                "MXC"
            ],
            "state":0,
            "isNew":false,
            "isHot":true,
            "isHidden":false,
            "conceptPlate": [
                "mc-trade-zone-grey",
                "mc-trade-zone-pow"
            ],
            "riskLimitType": "BY_VOLUME",
            "maxNumOrders": [
                200,
                50
            ],
            "marketOrderMaxLevel": 15,
            "marketOrderPriceLimitRate1": 0.03,
            "marketOrderPriceLimitRate2": 0.005,
            "triggerProtect": 0.05,
            "appraisal": 0,
            "showAppraisalCountdown": 0,
            "automaticDelivery": 0,
            "apiAllowed": false
        },
    ]
}

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	递增张数
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：按仓位价值

获取可划转币种

请求示例

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

响应示例

{
    "success": true,
    "code": 0,
    "data": [
        "BTC",
        "ETH",
        "USDT"
    ]
}

GET api/v1/contract/support_currencies

请求参数:

无

响应参数:

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

获取合约深度信息

请求示例

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

响应示例

{
    "asks":[
        [
            3968.5,
            121
        ],
        [
            3968.6,
            160,
            4
        ]
    ],
    "bids":[
        [
            3968.4,
            179,
            4
        ],
        [
            3968,
            914,
            3
        ]
    ],
    "version":1,
    "timestamp":1587442022003
}

GET api/v1/contract/depth/{symbol}

请求参数:

参数名	类型	是否必填	说明
symbol	string	true	合约名
limit	int	false	档位数

响应参数:

参数名	类型	说明
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": [
                [
                    31792,
                    59105,
                    1
                ]
            ],
            "bids": [],
            "version": 1481763378
        }
    ]
}

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": 31104.6,
        "timestamp": 1609829627708
    }
}

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.000489,
        "maxFundingRate": 0.001,
        "minFundingRate": -0.001,
        "collectCycle": 8,
        "nextSettleTime": 1609833600000,
        "timestamp": 1609829807577
    }
}

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": [
            1609740600
        ],
        "open": [
            33016.5
        ],
        "close": [
            33040.5
        ],
        "high": [
            33094.0
        ],
        "low": [
            32995.0
        ],
        "vol": [
            67332.0
        ],
        "amount": [
            222515.85925
        ]
    }
}

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": [
            1609740900
        ],
        "open": [
            33039.0
        ],
        "close": [
            33233.1
        ],
        "high": [
            33352.3
        ],
        "low": [
            33007.9
        ],
        "vol": [
            0.0
        ],
        "amount": [
            0.0
        ]
    }
}

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个数据。如果您希望在更大的时间范围内获取足够精细的数据，则需要使用多个开始/结束范围进行多次请求。

获取合理价格蜡烛图数据

请求示例

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": [
            1609740900
        ],
        "open": [
            33041.0
        ],
        "close": [
            33233.3
        ],
        "high": [
            33354.8
        ],
        "low": [
            33009.4
        ],
        "vol": [
            0.0
        ],
        "amount": [
            0.0
        ]
    }
}

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	时间窗口

获取成交数据

请求示例

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

响应示例

{
    "success": true,
    "code": 0,
    "data": [
        {
            "p": 31199,
            "v": 18,
            "T": 1,
            "O": 3,
            "M": 2,
            "t": 1609831235985
        },
        {
            "p": 31199,
            "v": 15,
            "T": 2,
            "O": 3,
            "M": 1,
            "t": 1609831234759
        }
    ]
}

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": {
        "symbol": "BTC_USDT",
        "lastPrice": 31199,
        "bid1": 31198.5,
        "ask1": 31199,
        "volume24": 40146908,
        "amount24": 124905007.4428,
        "holdVol": 55102960,
        "lower24Price": 27795,
        "high24Price": 33152.5,
        "riseFallRate": -0.0176,
        "riseFallValue": -562,
        "indexPrice": 31016.3,
        "fairPrice": 31199.5,
        "fundingRate": 0.001,
        "maxBidPrice": 31946.5,
        "minAskPrice": 30085.5,
        "timestamp": 1609831334016
    }
}

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": 425018.32968325152473812,
            "timestamp": 1609831395734
        },
        {
            "symbol": "BTC_USD",
            "currency": "BTC",
            "available": 5.00211366264782435,
            "timestamp": 1609831395734
        },
    ]
}

GET api/v1/contract/risk_reverse

请求参数:

无

响应参数:

参数名	类型	说明
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": 2,
        "totalCount": 42,
        "totalPage": 21,
        "currentPage": 1,
        "resultList": [
            {
                "symbol": "BTC_USDT",
                "currency": "USDT",
                "available": 424288.053161046680168662,
                "snapshotTime": 1609819200000
            },
            {
                "symbol": "BTC_USDT",
                "currency": "USDT",
                "available": 423989.817244106347071489,
                "snapshotTime": 1609804800000
            }
        ]
    }
}

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": 2,
        "totalCount": 21,
        "totalPage": 11,
        "currentPage": 1,
        "resultList": [
            {
                "symbol": "BTC_USDT",
                "fundingRate": 0.000266,
                "settleTime": 1609804800000
            },
            {
                "symbol": "BTC_USDT",
                "fundingRate": 0.00029,
                "settleTime": 1609776000000
            }
        ]
    }
}

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	结算时间

获取服务器时间​

获取合约信息​

获取可划转币种​

获取合约深度信息​

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

获取合约指数价格​

获取合约合理价格​

获取合约资金费率​

获取蜡烛图数据​

获取指数价格蜡烛图数据​

获取合理价格蜡烛图数据​

获取成交数据​

获取合约行情数据​

获取所有合约风险基金余额​

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

获取合约资金费率历史​

获取服务器时间

获取合约信息

获取可划转币种

获取合约深度信息

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

获取合约指数价格

获取合约合理价格

获取合约资金费率

获取蜡烛图数据

获取指数价格蜡烛图数据

获取合理价格蜡烛图数据

获取成交数据

获取合约行情数据

获取所有合约风险基金余额

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

获取合约资金费率历史