跳到主要内容

获取成交明细

限速规则 10次/1s (UID)交易员限速规则:1次/s(uid)

描述

获取成交明细(仅支持查询90天内数据,超过90天数据可以在网页端导出)

HTTP请求

  • GET /api/v2/spot/trade/fills
请求示例
curl "https://api.bitget.com/api/v2/spot/trade/fills?symbol=BTCUSDT&startTime=1659036670000&endTime=1659076670000&limit=20" \  
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \

请求参数

参数名参数类型是否必须描述
symbolString交易对名称
orderIdString订单ID
startTimeString成交订单的开始时间,即获取该时间戳以后的订单
Unix毫秒时间戳,例如1690196141868。(托管子账户访问时,StartTime 时间不能早于 绑定开始的时间)
endTimeString成交订单的结束时间,即获取该时间戳以前的订单
Unix毫秒时间戳,例如1690196141868
startTime和endTime的时间间隔不超过90天
limitString返回结果的数量,默认100,最大100
idLessThanString请求此ID之前(更旧的数据)的分页内容,传的值为对应接口的 endId。
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1695865274510,
"data": [
{
"userId": "**********",
"symbol": "BTCUSDT",
"orderId": "12345678910",
"tradeId": "12345678910",
"orderType": "market",
"side": "buy",
"priceAvg": "13000",
"size": "0.0007",
"amount": "9.1",
"feeDetail": {
"deduction": "no",
"feeCoin": "BTC",
"totalDeductionFee": "",
"totalFee": "-0.0000007"
},
"tradeScope": "taker",
"cTime": "1695865232579",
"uTime": "1695865233027"
}
]
}

返回参数

返回字段参数类型字段说明
userIdString账户ID
symbolString交易对名称
orderIdString订单ID
tradeIdString成交ID
orderTypeString订单类型
sideString委托方向
priceAvgString成交价格
sizeString成交数量
amountString成交总额
cTimeString创建时间
Unix毫秒时间戳,例如1622697148123
uTimeString更新时间
Unix毫秒时间戳,例如1622697148123
tradeScopeString交易者标识
taker 吃单方
maker 挂单方
feeDetailArray手续费明细
>deductionString是否折扣
>feeCoinString手续费币种
>totalDeductionFeeString总计折扣手续费
>totalFeeString总计手续费