获取成交明细
限速规则 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" \
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
symbol | String | 是 | 交易对名称 |
orderId | String | 否 | 订单ID |
startTime | String | 否 | 成交订单的开始时间,即获取该时间戳以后的订单 Unix毫秒时间戳,例如1690196141868。(托管子账户访问时,StartTime 时间不能早于 绑定开始的时间) |
endTime | String | 否 | 成交订单的结束时间,即获取该时间戳以前的订单 Unix毫秒时间戳,例如1690196141868 startTime和endTime的时间间隔不超过90天 |
limit | String | 否 | 返回结果的数量,默认100,最大100 |
idLessThan | String | 否 | 请求此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"
}
]
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
userId | String | 账户ID |
symbol | String | 交易对名称 |
orderId | String | 订单ID |
tradeId | String | 成交ID |
orderType | String | 订单类型 |
side | String | 委托方向 |
priceAvg | String | 成交价格 |
size | String | 成交数量 |
amount | String | 成交总额 |
cTime | String | 创建时间 Unix毫秒时间戳,例如1622697148123 |
uTime | String | 更新时间 Unix毫秒时间戳,例如1622697148123 |
tradeScope | String | 交易者标识 taker 吃单方 maker 挂单方 |
feeDetail | Array | 手续费明细 |
>deduction | String | 是否折扣 |
>feeCoin | String | 手续费币种 |
>totalDeductionFee | String | 总计折扣手续费 |
>totalFee | String | 总计手续费 |