跳到主要内容

获取历史委托

描述​

查询90天内的历史委托单

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

HTTP请求​

  • GET /api/v3/trade/history-orders
  • 限频规则: 20次/秒/UID
  • 需要统一账户交易只读/读写权限
请求示例
curl "https://api.bitget.com/api/v3/trade/history-orders?category=USDT-FUTURES" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数​

参数名参数类型是否必须描述
categoryString是产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
symbolString否交易对名称
例如：BTCUSDT
startTimeString否开始时间戳
Unix时间戳的毫秒数格式，如 1597026383085
最大查询范围90天
endTimeString否结束时间戳
Unix时间戳的毫秒数格式，如 1597026383085
startTime和endTime间隔不超过30天
limitString否每页条目数
最大100，默认100
cursorString否游标ID
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回的最小orderId，结果会返回小于该值的数据
返回示例
{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186348272,
  "data": {
    "list": [
      {
        "orderId": "111111111111111111",
        "clientOid": "111111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "orderType": "limit",
        "side": "sell",
        "price": "49534.4",
        "qty": "0.429",
        "amount": "0",
        "cumExecQty": "0.429",
        "cumExecValue": "21250.2929",
        "avgPrice": "49534.4",
        "timeInForce": "gtc",
        "orderStatus": "filled",
        "posSide": "long",
        "holdMode": "hedge_mode",
        "reduceOnly": "NO",
        "feeDetail": [
          {
            "feeCoin": "USDT",
            "fee": "4.2500586"
          }
        ],
        "cancelReason": "normal_cancel",
        "execType": "liquidation",
        "createdTime": "1730181468493",
        "updatedTime": "1730181468493"
      }
    ],
    "cursor": "1233319323918499840"
  }
}

返回参数​

返回字段参数类型字段说明
listArray
>orderIdString订单ID
>clientOidString自定义订单ID
>categoryString产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
>symbolString交易对名称
例如：BTCUSDT
>priceString委托价格
>qtyString委托数量
单位为base coin
>amountString委托金额
单位为quote coin
适用于现货和杠杆
>orderTypeString交易类型
limit: 限价
market: 市价
>cumExecQtyString累计成交数量
单位为base coin
>cumExecValueString累计成交额
单位为quote coin
>avgPriceString成交均价
>orderStatusString订单状态
live: 订单已创建
new: 订单已进入撮合
partially_filled: 部分成交
filled: 全部成交
cancelled: 已撤销
>sideString开单方向
buy: 买
sell: 卖
>timeInForceString订单有效期
ioc: 无法立即成交的部分就撤销
fok: 无法全部立即成交就撤
gtc: 普通订单, 订单会一直有效，直到被成交或者取消
post_only: 只做maker
>posSideString仓位方向
long: 双向持仓多头
short: 双向持仓空头
>holdModeString持仓模式
one_way_mode: 单向持仓
hedge_mode: 双向持仓
>reduceOnlyString是否减仓单
YES: 是
NO: 否
>feeDetailArray手续费明细
>> feeCoinString手续费币种
>> feeString手续费
>cancelReasonString撤销原因
normal_cancel: 常规撤销
>execTypeString执行类型
normal: 正常订单
offset: 轧差订单
reduce: 强制减仓单
liquidation: 爆仓单
delivery: 交割订单
>stpModeStringSTP模式（自成交预防）
none：不设置STP（默认值）
cancel_taker：取消taker单
cancel_maker：取消maker单
cancel_both：两者都取消
>createdTimeString创建时间
Unix毫秒时间戳
>updatedTimeString更新时间
Unix毫秒时间戳
cursorString分页游标