查询成交明细

描述

此接口用于查询合约订单的成交明细。

HTTP请求

GET /v3/trade/order/trades

请求参数

参数	是否必填	类型	描述
side	否	String	成交方向；枚举：BUY 和 SELL
symbol	否	String	交易对。常用形式为“基础货币”+“报价货币”
ordId	否	String	订单的订单 ID
clOrdId	否	String	用户自定义订单ID
sTime	否	String	查询开始时间，UNIX时间戳，以毫秒为单位。默认是最近90天
eTime	否	String	查询结束时间，UNIX时间戳，以毫秒为单位。默认是最近90天
from	否	Long	id，查询的起始id，默认从0开始
limit	否	Integer	分页页面大小，默认为10，最大为100。
direct	否	String	枚举：PREV, NEXT；默认是 NEXT

响应参数

参数	类型	描述
id	String	分页查询id
symbol	String	交易对。常用形式为“基础货币”+“报价货币”
clOrdId	String	用户自定义订单ID
ordId	String	订单id
trdId	String	成交id
side	String	枚举：BUY 和 SELL
type	String	成交类型；枚举：TRADE, LIQUIDATION, ADL, DELIVERY
mgnMode	String	枚举：ISOLATED, CROSS, CASH
posSide	String	持仓方向 LONG-多 或 SHORT-空, 单向持仓为BOTH。
ordType	String	订单类型；枚举：MARKET, LIMIT, LIMIT_MAKER
role	String	成交角色；枚举：MAKER, TAKER
px	String	成交价格
qty	String	成交数量
cTime	Long	撮合成交时间
uTime	Long	更新时间，默认为撮合成交时间
feeCcy	String	手续费币种名称
feeAmt	String	累计手续费数量
deductCcy	String	手续费抵扣币种名称
deductAmt	String	累计手续费抵扣数量
feeRate	String	手续费率

请求示例:

{
    "symbol":"BTC_USDT_PERP"
}

响应示例

{
    "code": 200,
    "data": [
        {
            "cTime": "1719973930900",
            "clOrdId": "polo331381602863284224",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00009405",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331381604734197760",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "MARKET",
            "px": "60000",
            "qty": "3",
            "role": "TAKER",
            "side": "SELL",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233280",
            "trdId": "100000010",
            "type": "TRADE",
            "uTime": "1719973930924"
        },
        {
            "cTime": "1719973768764",
            "clOrdId": "polo331380922769473536",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00009408",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331380924627804160",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "LIMIT",
            "px": "60000",
            "qty": "3",
            "role": "TAKER",
            "side": "BUY",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233289",
            "trdId": "100000009",
            "type": "TRADE",
            "uTime": "1719973768805"
        },
        {
            "cTime": "1719973712703",
            "clOrdId": "12345",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00009408",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331380688039698432",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "MARKET",
            "px": "60000",
            "qty": "3",
            "role": "TAKER",
            "side": "BUY",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233288",
            "trdId": "100000008",
            "type": "TRADE",
            "uTime": "1719973712728"
        },
        {
            "cTime": "1719919125209",
            "clOrdId": "polo331151680320307200",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.0000282195",
            "feeCcy": "USDT",
            "feeRate": "0.00015",
            "id": "331151731411378176",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "LIMIT",
            "px": "60000",
            "qty": "3",
            "role": "MAKER",
            "side": "SELL",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233287",
            "trdId": "100000007",
            "type": "TRADE",
            "uTime": "1719919125228"
        },
        {
            "cTime": "1719916971102",
            "clOrdId": "polo331142696133722112",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00006271",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331142696796676096",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "MARKET",
            "px": "60000",
            "qty": "2",
            "role": "TAKER",
            "side": "BUY",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233286",
            "trdId": "100000006",
            "type": "TRADE",
            "uTime": "1719916971125"
        },
        {
            "cTime": "1719912288938",
            "clOrdId": "988d6142-8b61-43d2-a689-5acbe4c72979",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00003135",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331123058117435393",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "MARKET",
            "px": "60000",
            "qty": "1",
            "role": "TAKER",
            "side": "SELL",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233285",
            "trdId": "100000005",
            "type": "TRADE",
            "uTime": "1719912289003"
        },
        {
            "cTime": "1719910543693",
            "clOrdId": "3701b9a4-8f91-4783-95f3-189bdf516f36",
            "deductAmt": "0",
            "deductCcy": "",
            "feeAmt": "0.00003135",
            "feeCcy": "USDT",
            "feeRate": "0.0005",
            "id": "331115738218094592",
            "mgnMode": "CROSS",
            "posSide": "BOTH",
            "ordType": "MARKET",
            "px": "60000",
            "qty": "1",
            "role": "TAKER",
            "side": "SELL",
            "symbol": "BTC_USDT_PERP",
            "ordId":"356743696043233284",
            "trdId": "100000004",
            "type": "TRADE",
            "uTime": "1719910543804"
        }
    ],
    "msg": "Success"
}