Transfer

Frequency limit:10 times/1s (User ID)

Description

The types of transfers supported by this interface include- Parent account rotor account (only parent account APIKey has access)- Sub-account to parent account (only parent account APIKey has access)- Sub-account rotor accounts (only the parent account APIKey has access and requires that the payee sub-accounts are the same parent account)The UIDs of the incoming and outgoing accounts in the request parameters must be mother-son/brother relationships, and only the mother account has access to all transfer operations.

HTTP request

• POST /api/v2/spot/wallet/transfer

Request Example

curl -X POST "https://api.bitget.com/api/v2/spot/wallet/transfer" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \  
   -d \'{
    "fromType":"spot",
    "toType":"isolated_margin",
    "amount":"300",
    "symbol":"BTCUSDT",
    "clientOid":"myclinetOid000001",
    "coin":"USDT"
}'

Request Parameter

Parameter	Type	Required	Description
fromType	String	Yes	Type of account to be transferred
toType	String	Yes	Recipient account type
amount	String	Yes	Amount to transfer
coin	String	Yes	Currency of transfer
symbol	String	Yes	Required when transferring to or from an account type that is a leveraged position-by-position account.
clientOid	String	No	Custom order ID

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1683875302853,
    "data": {
        "transferId": "123456",
        "clientOid": "x123"
    }
}

Response Parameters

Parameter	Type	Description
transferId	String	Transfer ID
clientOid	String	Custom order ID