Get Market Data Overview

/sapi/v1/market/detail/merged

Request type: GET

Signature verification: No

Interface permission: Read

Rate Limit: For public interface to get market data such as Get Kline data, Get Market Data Overview, Get Contract Information,Get market in-depth data, Get premium index Kline, Get real-time forecast capital rate kline, Get basis data, Get the last Trade of a Contract and so on： （1）For restful interfaces, products, (future, coin margined swap, usdt margined Contracts)800 times/second for one IP at most

Interface description: The interface supports cross margin mode and isolated margin mode. The request parameter "contract_code" supports the contract code of futures, in that the format is BTC-USDT-210625; and supports contract type: BTC-USDT, BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ.

Request Address

Environment	Address
Online	https://api.sunx.io
Online (preferred by aws customers)	https://api.sunx.io

Request Parameter

Parameter	Data Type	Required	Description	Value Range	Default Value
contract_code	string	true	contract code or contract type	swap: "BTC-USDT"... , future: "BTC-USDT-220325" ... or BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ

Response Parameter

Parameter	Data Type	Required	Description	Value Range
ch	string	true	Data belonged channel，format： market.$contract_code.detail.merged
status	string	true	Request Processing Result	"ok" , "error"
ts	long	true	Time of Respond Generation, Unit: Millisecond
<tick>	object	true	kline data (Start at 00:00(UTC+8) of the day)
id	long	true	kline id,the same as kline timestamp
vol	string	true	Trade Volume(Cont.), from nowtime - 24 hours. Sum of both buy and sell sides
count	decimal	true	Order Quantity, from nowtime - 24 hours. Sum of both buy and sell sides
open	string	true	Opening Price
close	string	true	Closing Price, the price in the last kline is the latest order price
low	string	true	Low
high	string	true	High
amount	string	true	Trade Amount(Coin), trade amount(coin)=sum(order quantity of a single order * face value of the coin/order price),from nowtime - 24 hours. Sum of both buy and sell sides
ask	array	true	Sell,[price(Ask price), vol(Ask orders (cont.) )], price in ascending sequence
bid	array	true	Buy,[price(Bid price), vol(Bid orders(Cont.))], Price in descending sequence
trade_turnover	string	true	Transaction amount, that is, sum (transaction quantity * contract face value * transaction price),from nowtime - 24 hours. Sum of both buy and sell sides
ts	long	true	Timestamp
</tick>		false

Request Example

GET https://api.sunx.io/sapi/v1/market/detail/merged?contract_code=BTC-USDT

Response Example

{
  "ch": "market.BTC-USDT.detail.merged",
  "status": "ok",
  "tick": {
    "amount": "12.526",
    "ask": [
      13084.2,
      131
    ],
    "bid": [
      13082.9,
      38
    ],
    "close": "13076.8",
    "count": 2920,
    "high": "13205.3",
    "id": 1603695162,
    "low": "12877.5",
    "open": "12916.2",
    "trade_turnover": "163247.3982",
    "ts": 1603695162580,
    "vol": "12526"
  },
  "ts": 1603695162580
}