获取市场最近成交记录

/sapi/v1/market/trade

请求类型: GET

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： （1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约和U本位合约）总共1秒最多800个请求

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。 business_type 在查询交割合约数据时为必填参数。且参数值要传：futures 或 all 。

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	false	合约代码 或 合约标识	永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type	string	false	业务类型，不填默认永续	futures：交割、swap：永续、all：全部

响应参数

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.$symbol.trade.detail
status	string	true		ok,"error"
<tick>	object	true
id	long	true	订单唯一id（品种唯一）
ts	long	true	最新成交时间
<data>	object array	true
amount	string	true	成交量(张)。 值是买卖双边之和
direction	string	true	买卖方向，即taker(主动成交)的方向
id	long	true	成交唯一id（品种唯一）
price	string	true	成交价
ts	long	true	成交时间
quantity	string	true	成交量（币）
contract_code	string	true	合约代码
business_type	string	true	业务类型	futures：交割、swap：永续
trade_turnover	string	true	成交额（计价币种）
trade_partition	string	true	参数已废弃
</data>		false
</tick>		false
ts	long	true	发送时间

请求示例

curl "https://api.sunx.io/sapi/v1/market/trade"

响应示例

{
    "ch": "market.BTC-USDT.trade.detail",
    "status": "ok",
    "tick": {
        "data": [
            {
                "amount": "2",
                "quantity": "0.002",
                "trade_turnover": "231.1328",
                "ts": 1758015518607,
                "id": 1000000192444090000,
                "price": "115566.4",
                "direction": "sell",
                "contract_code": "BTC-USDT",
                "business_type": "swap",
                "trade_partition": "USDT"
            }
        ],
        "id": 1758016716711,
        "ts": 1758016716711
    },
    "ts": 1758016716711
}