Request Trade Detail Data

market.$contract_code.trade.detail

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： For websocket: The rate limit for “req” request is 50 times at once. No limit for “sub” request as the data will be pushed by sever voluntarily.

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.

Subscription Address

Environment	Address
Online	wss://api.sunx.io/ws/v1/market
Online (preferred by aws customers)	wss://api.sunx.io/ws/v1/market

Subscription 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-210625" ... or BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ

Data Update

Parameter	Data Type	Required	Description	Value Range
rep	string	true	Data Channel，Format： market.$contract_code.trade.detail
status	string	true	Request Status
id	long	true	Request ID
<data>		false
id	long	true	Unique Transaction Id(symbol level)
price	string	true	Price
amount	string	true	Quantity(Cont.). Sum of both buy and sell sides
direction	string	true	The direction to buy or sell is the direction of the taker (active transaction)
ts	long	true	Order Creation Time
quantity	string	true	trading quantity(coin)
trade_turnover	string	true	trade turnover(quoted currency)
</data>		false
ts	long	true	server response time

Notes: There are "quantity" parameter in return data only after 21:00:00 on February 3, 2021

Subscription Example

{
  "req": "market.BTC-USDT.trade.detail",
  "size": 50,
  "id": "id8"
}

Example of a Successful Subscription

{
  "data": [
    {
      "amount": "22",
      "ts": 1603706942240,
      "id": 1315909380000,
      "price": "13068.4",
      "direction": "sell",
      "quantity": "0.022",
      "trade_turnover": "288.334"
    },
    {
      "amount": "2",
      "ts": 1603706947767,
      "id": 1315909430000,
      "price": "13068.5",
      "direction": "buy",
      "quantity": "0.002",
      "trade_turnover": "26.334"
    }
  ],
  "id": "id8",
  "rep": "market.BTC-USDT.trade.detail",
  "status": "ok",
  "ts": 1603708046534
}