跳到主要内容

行情接口

历史行情数据下载​

提供2023年01月01日以来的K线和交易历史数据下载：历史行情数据下载

测试服务器连通性​

测试能否联通 Rest API。

请求示例

GET /api/v3/ping

返回示例

{}

HTTP请求

  • GET /api/v3/ping

权重(IP): 1

请求参数

NONE

返回参数

NONE

获取服务器时间​

获得服务器当前时间戳

请求示例

GET /api/v3/time

返回示例

{
    "serverTime" : 1645539742000
}

HTTP请求

  • GET /api/v3/time

权重(IP): 1

请求参数

NONE

API交易对​

获取平台可API交易的交易对

请求示例

GET /api/v3/defaultSymbols

返回示例

{
    "code": 200,
    "data": [
        "GENE1USDT",
        "SNTUSDT",
        "SQUAWKUSDT",
        "HEGICUSDT",
        "GUMUSDT"
    ],
    "msg": null
}

HTTP请求

  • GET /api/v3/defaultSymbols

权重(IP): 1

请求参数

NONE

返回参数

参数名数据类型说明
symbolstring返回支持API交易的交易对

交易规范信息​

获取交易规则和交易对信息。

请求示例

GET /api/v3/exchangeInfo?symbol=BTCUSDT

返回示例

{
    "symbol": "METALUSDT",
    "status": "1",
    "baseAsset": "METAL",
    "baseAssetPrecision": 2,
    "quoteAsset": "USDT",
    "quotePrecision": 5,
    "quoteAssetPrecision": 5,
    "baseCommissionPrecision": 2,
    "quoteCommissionPrecision": 5,
    "orderTypes": [
        "LIMIT",
        "MARKET",
        "LIMIT_MAKER"
    ],
    "isSpotTradingAllowed": true,
    "isMarginTradingAllowed": false,
    "quoteAmountPrecision": "1",
    "baseSizePrecision": "0.1",
    "permissions": [
        "SPOT",
    ],
    "filters": [
        {
          "filterType": "PERCENT_PRICE_BY_SIDE",//过滤器类型
          "bidMultiplierUp": "5",//买单价格限制阈值               
          "askMultiplierDown": "0.2"//卖单价格限制阈值   
        },

    ], 
    "maxQuoteAmount": "2000000",
    "makerCommission": "0",
    "takerCommission": "0.0005",
    "quoteAmountPrecisionMarket": "1",
    "maxQuoteAmountMarket": "100000",
    "fullName": "Metal Blockchain",
    "tradeSideType":"1",
    "contractAddress": "xtokens",
    "st": false
}

HTTP请求

  • GET /api/v3/exchangeInfo

权重(IP): 10

请求参数

三种用法

用法举例
不需要交易对curl -X GET "https://api.mexc.com/api/v3/exchangeInfo"
单个交易对curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbol=MXUSDT"
多个交易对curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbols=MXUSDT,BTCUSDT"

返回参数

参数名数据类型说明
timezonestring时区
serverTimelong服务器时间
rateLimitsArray频率限制
exchangeFiltersArray过滤器
symbolString交易对
statusString状态:1 - 开放， 2 - 暂停， 3 - 下线
baseAssetString交易币
baseAssetPrecisionInt交易币精度
quoteAssetString计价币
quotePrecisionInt计价币价格精度
quoteAssetPrecisionInt计价币资产精度
baseCommissionPrecisionInt交易币手续费精度
quoteCommissionPrecisionInt计价币手续费精度
orderTypesArray订单类型
isSpotTradingAllowedBoolean是否允许api现货交易
isMarginTradingAllowedBoolean是否允许api杠杆交易
permissionsArray权限
filterTypeString过滤器类型，枚举值：PERCENT_PRICE_BY_SIDE
bidMultiplierUpString买单价格限制阈值
askMultiplierDownString卖单价格限制阈值
maxQuoteAmountString最大下单金额
makerCommissionStringmarker手续费
takerCommissionStringtaker手续费
quoteAmountPrecisionstring最小下单金额
baseSizePrecisionstring最小下单数量
quoteAmountPrecisionMarketstring市价最小下单金额
maxQuoteAmountMarketString市价最大下单金额
tradeSideTypeString交易对可交易方向:1 - 全部， 2 - 仅买单， 3 - 仅卖单，4 - 关闭
contractAddressString合约地址
stString交易对st标签展示状态,0-关闭=false, 1-开启=true

filter参数说明:

  • lastPrice表示用最新价成交价,orderPrice表示下单价格。
  • 买向订单需要满足(仅限LIMIT、IMMEDIATE_OR_CANCEL、FILL_OR_KILL) : orderPrice <= lastPrice * bidMultiplierUp
  • 卖向订单需要满足: orderPrice >= lastPrice * askMultiplierDown

深度信息​

获取指定交易对的深度信息，默认返回买卖盘各100条信息

请求示例

GET /api/v3/depth?symbol=BTCUSDT&limit=200

返回示例

{
 
  "lastUpdateId": 1377043284,
  "bids": [
        ["30225.77","2.132868"],
        ],
  "asks": [
        ["30225.80","1.130244"],
        ],
}

HTTP请求

  • GET /api/v3/depth

权重(IP): 基于限制调整

请求参数

参数名数据类型是否必须说明取值范围
symbolstring是交易对名称如：BTCUSDT
limitinteger否返回的条数默认 100; 最大 5000

返回参数

参数名数据类型说明
lastUpdateIdlong最新更新ID
bidslist买盘 [价位, 挂单量]
askslist卖盘 [价位, 挂单量]

近期成交列表​

获取指定交易对的近期成交信息，默认返回最近500条成交信息。

请求示例

GET /api/v3/trades?symbol=BTCUSDT&limit=600

返回示例

[
  {
    "id": null,
    "price": "29919.62",
    "qty": "1.292918",
    "quoteQty": "38683.61525116",
    "time": 1652848049876,
    "isBuyerMaker": true,
    "isBestMatch": true
  },
]

HTTP请求

  • GET /api/v3/trades

权重(IP): 5

请求参数

参数名数据类型是否必须说明取值范围
symbolstring是交易对名称如：BTCUSDT
limitinteger否返回的条数默认 500; 最大 1000

返回参数

参数名说明
id成交id
price价格
qty数量
quoteQty成交额
time成交时间
isBuyerMaker是否为maker单
isBestMatch是否为最佳匹配

近期成交(归集)​

归集交易与逐笔交易的区别在于，同一价格、同一方向、同一时间的trade会被聚合为一条

请求示例

GET /api/v3/aggTrades?symbol=BTCUSDT

返回示例

[
  {
    "a": null,
    "f": null,
    "l": null,
    "p": "29881.4",
    "q": "0.010068",
    "T": 1652848230000,
    "m": false,
    "M": true
  },
]

HTTP请求

  • GET /api/v3/aggTrades

权重(IP): 1

请求参数

参数名数据类型是否必须说明取值范围
symbolstring是交易对名称 如：BTCUSDT
startTimelong否从该时刻之后的成交记录开始返回结果
endTimelong否返回该时刻为止的成交记录
limitinteger否返回的条数默认 500; 最大 1000

注意：startTime和endTime需同时使用

返回参数

参数名说明
a归集成交ID
f被归集的首个成交ID
l被归集的末个成交ID
p成交价
q成交量
T成交时间
m是否为主动卖出单
M是否为最优撮合单(可忽略，目前总为最优撮合)

K线数据​

获取指定交易对的k线数据，每根K线代表一个交易对。每根K线的开盘时间可视为唯一ID。

请求示例

GET /api/v3/klines?symbol=BTCUSDT&interval=1m&startTime=1652848049876&endTime=1652848650458

返回示例

[
  [
    1652818380000,
    "30082.28",
    "30105.66",
    "30082.28",
    "30084.65",
    "5.838067",
    1652818440000,
    "175741.13"
  ],
]

HTTP请求

  • GET /api/v3/klines

权重(IP): 1

请求参数

参数名数据类型是否必须说明
symbolstring是交易对名称 如：BTCUSDT
intervalENUM是见枚举定义：k线间隔 如：1m
startTimelong否如：1652848049876
endTimelong否如：1652848650458
limitinteger否默认 500; 最大 1000

注意：startTime和endTime需同时使用

返回参数

索引说明
0开盘时间
1开盘价
2最高价
3最低价
4收盘价
5成交量
6收盘时间
7成交额

当前平均价格​

获取指定交易对在一定时间范围内的平均价格。

请求示例

GET /api/v3/avgPrice?symbol=BTCUSDT

返回示例

{
  "mins": 5,
  "price": "29869.882"
}

HTTP请求

  • GET /api/v3/avgPrice

权重(IP): 1

请求参数

参数名数据类型是否必须说明
symbolstring是交易对名称。如：BTCUSDT

返回参数

参数名说明
mins均价时间范围
price价格

24小时价格滚动情况​

获取指定交易对或者所有交易对在24小时内的价格滚动（5分钟为单位）

请求示例

GET /api/v3/ticker/24hr?symbol=BTCUSDT

返回示例

{
    "symbol": "BTCUSDT",
    "priceChange": "1588.47",
    "priceChangePercent": "0.07791949",
    "prevClosePrice": "20386.04",
    "lastPrice": "21974.51",
    "bidPrice": "21974.48",
    "bidQty": "0.645732",
    "askPrice": "21974.51",
    "askQty": "5.801688",
    "openPrice": "20386.04",
    "highPrice": "22508.06",
    "lowPrice": "20269.12",
    "volume": "6381.884246",
    "quoteVolume": "135594952.21",
    "openTime": 1657258200000,
    "closeTime": 1657258407860,
    "count": null
}

HTTP请求

  • GET /api/v3/ticker/24hr

权重(IP): 1单交易对/40所有交易对

请求参数

参数名数据类型是否必须说明
symbolstring否交易对名称 不传查全部（谨慎使用） 如：BTCUSDT

返回参数

参数名说明
symbol交易对
priceChange价格变化
priceChangePercent价格变化比
prevClosePrice前一收盘价
lastPrice最新价
lastQty最新量
bidPrice买盘价格
bidQty买盘数量
askPrice卖盘价格
askQty卖盘数量
openPrice开始价
highPrice最高价
lowPrice最低价
volume成交量
quoteVolume成交额
openTime开始时间
closeTime结束时间
count

最新价格​

获取指定交易对或者所有交易对的最新价格

请求示例

GET /api/v3/ticker/price?symbol=BTCUSDT

返回示例

{
    "symbol": "BTCUSDT",
    "price": "29805.02"
}

HTTP请求

  • GET /api/v3/ticker/price

**权重(IP):**1 单一交易对;2 交易对参数缺失

请求参数

参数名数据类型是否必须说明
symbolstring否交易对名称 不传查全部 如：BTCUSDT

返回参数

参数名说明
symbol交易对
price最新价格

当前最优挂单​

获取当前最优的挂单(最高买单，最低卖单)

请求示例

GET /api/v3/ticker/bookTicker?symbol=BTCUSDT

返回示例

{
    "symbol": "BTCUSDT",
    "bidPrice": "29820.79",
    "bidQty": "2.241948",
    "askPrice": "29820.82",
    "askQty": "2.301948"
}

HTTP请求

  • GET /api/v3/ticker/bookTicker

**权重(IP):**1 单一交易对;2 交易对参数缺失;

请求参数

参数名数据类型是否必须说明
symbolstring否交易对名称 不传查全部 如：BTCUSDT

返回参数

参数名说明
symbol交易对
bidPrice最高买盘价
bidQty最高买盘数量
askPrice最低卖盘价
askQty最低卖盘数量