Skip to main content

Trade Details

Get Trade Details

Get trade execution details

Request frequency limit: 1/1s

Request URL

GET /deepcoin/trade/fills

Request Parameters

Field NameRequiredTypeDescription
instTypetruestringProduct type
Spot: SPOT
Contract: SWAP
instIdfalsestringProduct ID
ordIdfalsestringOrder ID
afterfalsestringPagination of data before this ID (older data), value should be billId from the response
beforefalsestringPagination of data after this ID (newer data), value should be billId from the response
beginfalseintegerRequest trade details after this timestamp, Unix timestamp in milliseconds
endfalseintegerRequest trade details before this timestamp, Unix timestamp in milliseconds
limitfalseintegerNumber of results per page, maximum 100, default 100

Response Parameters

Field NameTypeDescription
instTypestringProduct type
instIdstringProduct ID
tradeIdstringLatest trade ID
ordIdstringOrder ID
clOrdIdstringCustom order ID
billIdstringBill ID
tagstringOrder tag
fillPxstringLatest fill price
fillSzstringLatest fill size
sidestringOrder side
Buy: buy
Sell: sell
posSidestringPosition side
Long: long
Short: short
execTypestringExecution type
Taker: T
Maker: M
feeCcystringFee currency or rebate currency
feestringTrading fee
tsstringTrade details generation time, Unix timestamp in milliseconds

Response Example

{
"code": "0",
"msg": "",
"data": [
{
"instType": "SWAP",
"instId": "BTC-USDT-SWAP",
"tradeId": "1000169956494218",
"ordId": "1000587866072658",
"clOrdId": "",
"billId": "10001699564942181",
"tag": "",
"fillPx": "98230.5",
"fillSz": "200",
"side": "sell",
"posSide": "short",
"execType": "T",
"feeCcy": "USDT",
"fee": "5.89383",
"ts": "1739261250000"
},
{
"instType": "SWAP",
"instId": "BTC-USDT-SWAP",
"tradeId": "1000169956494217",
"ordId": "1000587866072658",
"clOrdId": "",
"billId": "10001699564942171",
"tag": "",
"fillPx": "98230.5",
"fillSz": "50",
"side": "sell",
"posSide": "short",
"execType": "T",
"feeCcy": "USDT",
"fee": "1.4734575",
"ts": "1739261250000"
}
]
}