Get Move Position History

Description

Query the history of position moves. Only callable by the master account. You can query the move position history for a specified source account (master account or sub-account).

• Query Range Constraint
  If endTime is not provided, the default query range is the last 30 days. The maximum supported time span is 90 days.

HTTP Request

• GET /api/v3/account/move-position-history
• Rate limit: 5/sec/UID
• Permission: UTA trade (read)

Request

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:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameter	Type	Required	Comments
category	String	Yes	Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
symbol	String	No	Symbol name e.g., BTCUSDT
startTime	String	No	Start timestamp A Unix timestamp in milliseconds e.g., 1597026383085
endTime	String	No	End timestamp A Unix timestamp in milliseconds e.g., 1597026383185 If not provided, defaults to querying the last 30 days. Maximum supported time span is 90 days
cursor	String	No	Cursor Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages
limit	String	No	Limit per page Default: 100. Maximum: 100

Response

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

Response Parameters

Parameter	Type	Comments
list	Array	Move position history list
>category	String	Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
>fromUid	String	Source account UID
>toUid	String	Target account UID
>orderId	String	Order ID
>openExecId	String	Open Position Execution ID
>closeExecId	String	Close Position Execution ID
>symbol	String	Symbol name e.g., BTCUSDT
>posSide	String	Position side long Long position short Short position
>qty	String	Transfer quantity
>price	String	Transfer price
>status	String	Transfer status processing In progress completed Completed failed Failed
>createdTime	String	Created timestamp A Unix millisecond timestamp
>updatedTime	String	Updated timestamp A Unix millisecond timestamp
cursor	String	Cursor