批量获取最近的交易记录

/sapi/v1/market/history/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（次季）。

请求地址

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

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	true	合约代码 或 合约标识	永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
size	int	true	获取交易记录的数量，默认1	[1, 2000]

响应参数

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.$contract_code.trade.detail
<data>	object array	true
<data>	object array	true
amount	decimal	true	成交量(张)。 值是买卖双边之和
direction	string	true	买卖方向，即taker(主动成交)的方向
id	long	true	成交唯一id（品种唯一）
price	decimal	true	成交价格
ts	long	true	成交时间
quantity	decimal	true	成交量（币）
trade_turnover	decimal	true	成交额（计价币种）
</data>		false
id	long	true	订单唯一id（品种唯一）
ts	long	true	最新成交时间
</data>		false
status	string	true		ok，"error"
ts	long	true	响应生成时间点，单位：毫秒

请求示例

GET https://api.sunx.io/sapi/v1/market/history/trade?contract_code=BTC-USDT&size=1

响应示例

{
    "ch": "market.BTC-USDT.trade.detail",
    "ts": 1757932114663,
    "status": "ok",
    "data": [
        {
            "id": 100000016279612,
            "ts": 1757932102168,
            "data": [
                {
                    "amount": 2,
                    "quantity": 0.002,
                    "trade_turnover": 229.4006,
                    "ts": 1757932102168,
                    "id": 1000000162796120000,
                    "price": 114700.3,
                    "direction": "sell"
                }
            ]
        }
    ]
}