获取移仓历史

描述

当前仅限模拟盘

查询移仓历史记录。仅支持母账户调用。

• 查询时间范围
  如不传endTime，默认查询最近30天数据。最大支持的时间跨度为90天。

HTTP请求

• GET /api/v3/account/move-position-history
• 限频规则: 5次/秒/UID
• 需要统一账户交易只读/读写权限

请求示例

curl "https://api.bitget.com/api/v3/account/move-position-history?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"

请求参数

参数名	参数类型	是否必须	描述
category	String	是	产品类型 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
symbol	String	否	交易对名称 例如：BTCUSDT
startTime	String	否	开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085
endTime	String	否	结束时间戳 Unix时间戳的毫秒数格式，如 1597026383185 如不传，默认查询最近30天数据 最大支持的时间跨度为90天
cursor	String	否	游标ID 用于分页。首次不传，后续传上次响应结果
limit	String	否	每页条目数 默认值为100，最大值为100

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186348272,
  "data": {
    "list": [
      {
        "category": "USDT-FUTURES",
        "fromUid": "111111111",
        "toUid": "222222222",
        "orderId": "121211212122",
        "execId": "343434343434",
        "symbol": "BTCUSDT",
        "posSide": "long",
        "qty": "0.5",
        "price": "61000",
        "status": "completed",
        "createdTime": "1730181468493",
        "updatedTime": "1730181468593"
      }
    ],
    "cursor": "1233319323918499840"
  }
}

返回参数

返回字段	参数类型	字段说明
list	Array	移仓历史列表
>category	String	产品类型 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
>fromUid	String	发起账户UID
>toUid	String	目标账户UID
>orderId	String	订单ID
>execId	String	成交ID
>symbol	String	交易对名称 例如：BTCUSDT
>posSide	String	仓位方向 long 多仓 short 空仓
>qty	String	转移数量
>price	String	转移价格
>status	String	转移状态 processing 处理中 completed 已完成 failed 失败
>createdTime	String	订单创建时间 Unix毫秒时间戳
>updatedTime	String	订单更新时间 Unix毫秒时间戳
cursor	String	分页游标