获取成交明细
限速规则 10次/1s (UID)交易员限速规则：1次/s（uid）
描述
获取成交明细
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 | 总计手续费 |