# 现货行情

# k线数据

GET /v1/spot/market/klines

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT
period	String	是	返回数据时间粒度，也就是每根蜡烛的时间区间，可选值: [1min,5min,15min,30min,60min,4hour,1day,1mon,1week]
limit	Int	否	返回K线数据条数，可选值[1,1000],默认150

# 响应参数

名称	类型	描述
id	Long	UTC时间的时间戳，单位秒，并以此作为此K线柱的id
symbol	String	交易对
period	String	时间粒度
high	Decimal	本阶段最高价
open	Decimal	本阶段开盘价
low	Decimal	本阶段最低价
close	Decimal	本阶段收盘价
amount	Decimal	以基础币种计量的交易量
vol	Decimal	以报价币种计量的交易量
count	Int	交易次数

# 请求示例

GET /v1/spot/market/klines?limit=150&period=1min&symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264134584",
  "data": [
    {
      "symbol": "BTC/USDT",
      "period": "1min",
      "id": "1687264080",
      "high": "26908.99",
      "open": "26901.4",
      "low": "26851.89",
      "close": "26862.72",
      "amount": "68.58573",
      "vol": "1844070.146055",
      "count": "191"
    },
    {
      "symbol": "BTC/USDT",
      "period": "1min",
      "id": "1687264020",
      "high": "26944.96",
      "open": "26937.17",
      "low": "26894.59",
      "close": "26901.4",
      "amount": "61.98514",
      "vol": "1668826.217133",
      "count": "121"
    }
  ]
}

# 最近市场成交记录

GET /v1/spot/market/trade

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT

# 响应参数

名称	类型	描述
trades	Array	成交记录
\| amount	Decimal	成交量
\| price	Decimal	成交价
\| direction	String	成交主动方 (taker的订单方向) BUY、SELL
\| timestamp	Long	成交时间
\| tradeId	Long	成交id
\| symbol	String	交易对
\| vol	Decimal	成交额（计价币种）

# 请求示例

GET /v1/spot/market/trade?symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264383325",
  "data": {
    "trades": [
      {
        "amount": "1.07729",
        "price": "26836.99",
        "direction": "SELL",
        "timestamp": "1687264380148"
        "tradeId": "596645628754759680",
        "symbol": "BTC/USDT",
        "vol": "28911.2209571"
      }
    ]
  }
}

# 市场深度数据

GET /v1/spot/market/depth

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT
limit	Int	否	返回深度的数量,可选值:[5, 10, 20, 50, 100, 500],默认100

# 响应参数

名称	类型	描述
asks	array	当前的所有卖单 [price, size]
bids	array	当前的所有买单 [price, size]

# 请求示例

GET /v1/spot/market/depth?limit=5&symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264098931",
  "data": {
    "bids": [
      [
        "26880.85",
        "1.80307"
      ],
      [
        "26877.08",
        "1.0218"
      ],
      [
        "26876.45",
        "1.17699"
      ],
      [
        "26876.37",
        "1.25906"
      ],
      [
        "26876.04",
        "1.93795"
      ]
    ],
    "asks": [
      [
        "26934.68",
        "1.31659"
      ],
      [
        "26935.62",
        "1.92772"
      ],
      [
        "26941.93",
        "1.11408"
      ],
      [
        "26971.91",
        "1.62224"
      ],
      [
        "26972.03",
        "1.20742"
      ]
    ]
  }
}

# 聚合行情

GET /v1/spot/market/ticker

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT

# 响应参数

名称	类型	描述
id	Int	查询开始时间，单位：s
symbol	String	交易对
high	Decimal	本阶段最高价（以滚动24小时计）
open	Decimal	本阶段开盘价（以滚动24小时计）
low	Decimal	本阶段最低价（以滚动24小时计）
close	Decimal	本阶段最新价（以滚动24小时计）
amount	Decimal	以基础币种计量的交易量（以滚动24小时计）
vol	Decimal	以报价币种计量的交易量（以滚动24小时计）
count	Int	交易次数（以滚动24小时计）
priceChangePercent	Decimal	价格变化百分比
bid	Array	当前的最高买价 [price, amount]
ask	Array	当前的最低卖价 [price, amount]

# 请求示例

GET /v1/spot/market/ticker?symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264449117",
  "data": {
    "symbol": "BTC/USDT",
    "id": "1687264449104",
    "high": "26974.41",
    "open": "25591.31",
    "low": "25576.42",
    "close": "26849.06",
    "amount": "54965.37335",
    "vol": "1421314041.6349009",
    "count": "36667",
    "priceChangePercent": "0.049147542661",
    "bid": [
      "26826.11",
      "1.4072"
    ],
    "ask": [
      "26879.84",
      "1.81495"
    ]
  }
}

# 获取近期交易记录

GET /v1/spot/market/trade/history

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT
limit	Int	否	返回的交易记录数量,可选值[1,2000],默认1

# 响应参数

名称	类型	描述
trades	Array	成交记录
\| amount	Decimal	成交量
\| price	Decimal	成交价
\| direction	String	成交主动方 (taker的订单方向) BUY、SELL
\| timestamp	Long	成交时间
\| tradeId	Long	成交id
\| symbol	String	交易对
\| vol	Decimal	成交额（计价币种）

# 请求示例

GET  v1/spot/market/trade/history?limit=1&symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264491542",
  "data": {
    "trades": [
      {
        "amount": "1.56101",
        "price": "26857.25",
        "direction": "BUY",
        "timestamp": "1687264490152",
        "tradeId": "596790985111343104",
        "symbol": "BTC/USDT",
        "vol": "41924.4358225"
      }
    ]
  }
}

# 最近24小时行情数据

GET /v1/spot/market/ticker24h

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		5

# 参数

名称	类型	必填	描述
symbol	String	是	交易对,eg.BTC/USDT

# 响应参数

名称	类型	描述
id	Int	查询开始时间，单位：s
symbol	String	交易对
high	Decimal	本阶段最高价（以滚动24小时计）
open	Decimal	本阶段开盘价（以滚动24小时计）
low	Decimal	本阶段最低价（以滚动24小时计）
close	Decimal	本阶段最新价（以滚动24小时计）
amount	Decimal	以基础币种计量的交易量（以滚动24小时计）
vol	Decimal	以报价币种计量的交易量（以滚动24小时计）
count	Int	交易次数（以滚动24小时计）
priceChangePercent	Decimal	价格变化百分比

# 请求示例

GET /v1/spot/market/ticker24h?symbol=BTC/USDT

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264529031",
  "data": {
    "symbol": "BTC/USDT",
    "id": "1687264529026",
    "high": "26974.41",
    "open": "25582.15",
    "low": "25576.42",
    "close": "26857.27",
    "amount": "54991.02497",
    "vol": "1422073144.0360743",
    "count": "36682",
    "priceChangePercent": "0.049844129598"
  }
}

# 全量24小时行情数据

GET /v1/spot/market/fullTicker24h

所属模块	所属类型	资源隔离类型	速率限制
现货行情(SPOT_MARKET)	查询(QUERY)		50

# 参数

NONE

# 响应参数

名称	类型	描述
id	Int	查询开始时间，单位：s
symbol	String	交易对
high	Decimal	本阶段最高价（以滚动24小时计）
open	Decimal	本阶段开盘价（以滚动24小时计）
low	Decimal	本阶段最低价（以滚动24小时计）
close	Decimal	本阶段最新价（以滚动24小时计）
amount	Decimal	以基础币种计量的交易量（以滚动24小时计）
vol	Decimal	以报价币种计量的交易量（以滚动24小时计）
count	Int	交易次数（以滚动24小时计）
priceChangePercent	Decimal	价格变化百分比

# 请求示例

GET /v1/spot/market/fullTicker24h

# 响应示例

{
  "code": "200",
  "message": "OK",
  "timestamp": "1687264529055",
  "data": [
    {
      "symbol": "BTC/USDT",
      "id": "1687264529041",
      "high": "68036.96",
      "open": "67757.88",
      "low": "67591.61",
      "close": "67765.12",
      "amount": "37.17293",
      "vol": "2522864.9923825",
      "count": "10614",
      "priceChangePercent": "0.000106851041"
    },
    {
      "symbol": "TRX/USDT",
      "id": "1687264529045",
      "high": "0.11212",
      "open": "0.111789",
      "low": "0.111009",
      "close": "0.11192",
      "amount": "2612328.05",
      "vol": "291183.50239715",
      "count": "26256",
      "priceChangePercent": "0.00117185054"
    }
  ]
}

← 账户接口现货订单 →