获取成交明细

描述

获取用户最近90天内委托单成交明细

• 查询时间范围
  每次查询只支持查询90天内的30天数据

HTTP请求

• GET /api/v3/trade/fills
• 限频规则: 20次/秒/UID
• 需要统一账户交易只读/读写权限

请求示例

curl "https://api.bitget.com/api/v3/trade/fills?orderId=111111111111111111" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
category	String	否	产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
orderId	String	否	订单ID
startTime	String	否	开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085 最大查询范围90天
endTime	String	否	结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 startTime和endTime间隔不超过30天
limit	String	否	查询条数 最大100，默认100
cursor	String	否	分页游标 用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1750142995229,
  "data": {
    "list": [
      {
        "execId": "131111111111111111",
        "execLinkId": "131111111111111111",
        "orderId": "131111111111111111",
        "clientOid": "131111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "orderType": "market",
        "side": "sell",
        "tradeSide": "open",
        "execPrice": "106950.1",
        "execQty": "0.01",
        "execValue": "1069.501",
        "tradeScope": "taker",
        "feeDetail": [
          {
            "feeCoin": "USDT",
            "fee": "0.6417006"
          }
        ],
        "createdTime": "1750141421721",
        "updatedTime": "1750141421728",
        "execPnl": "-0.002"
      }
    ],
    "cursor": "131111111111111111"
  }
}

返回参数

返回字段	参数类型	字段说明
list	Array	成交明细集合
>execId	String	成交ID
>execLinkId	String	成交关联ID
>orderId	String	订单ID
>clientOid	String	自定义订单ID
>category	String	产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
>symbol	String	交易对名称
>orderType	String	订单类型 limit 限价单 market 市价单
>execPrice	String	成交价格
>execQty	String	交易币成交数量 单位为base coin
>execValue	String	计价币交易额 单位为quote coin
>feeDetail	String	手续费明细
>>feeCoin	String	手续费币种
>>fee	String	手续费
>side	String	成交类型 buy 买 sell 卖
>tradeScope	String	交易方标识 taker: Taker maker: Maker
>tradeSide	String	交易方向 open: 开 close : 平 详细枚举可以在 枚举 页面获取
>createdTime	String	订单创建时间 Unix毫秒时间戳，例如1690196141868
>updatedTime	String	订单更新时间 Unix毫秒时间戳，例如1690196141868
>execPnl	String	成交盈亏
cursor	String	分页游标