Assets

Endpoint

Download Schema

Transfer between accounts

Transfer between accounts.

POST

/api/v3/wallet/transfer/self

https://api-spot.weex.com

Request weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate-limit capacity.

Learn more in the Access Restrictions section.

IP weight20

Transfer between accounts › Request Body

amount

string · required

Transfer amount. Must be greater than 0 and respect the configured coin precision; excess precision returns -1160.

fromAccountType

string · required

Source account type: UNIMARGIN (futures account), SPOT (spot account), or FUNDING (funding account).

toAccountType

string · required

Destination account type. Uses the same values as fromAccountType and must be different from the source account.

coin

string · required

Asset code.

bizId

string

Business ID. If specified, the business ID must contain 16-32 ASCII letters or numbers and may include the openapi_ prefix. The server adds the prefix if absent, stores and returns the final ID, or generates openapi_ plus 32 random characters when omitted.

params

string

Business remark or additional information.

Transfer between accounts › Responses

200

Successful response

code

integer

Business code. 0 indicates success.

msg

string

Response message.

object

bizId

string

Business ID used for the transfer.

result

boolean

true indicates a successful transfer.

transferId

string | null

Transfer ID. May be Null.

-2413

string

Insufficient balance.

-2442

string

Asset transfer failed.

-2443

string

Asset transfer is processing. Retry with the same bizId.

-2444

string

fromAccountType and toAccountType cannot be the same.

-2445

string

bizId already exists. Reuse it only with the original request parameters.

-2446

string

Legacy spot account is not supported. Use SPOT instead.

-2447

string

bizId must contain 16 to 32 ASCII letters or digits, optionally prefixed with 'openapi_'.

-2452

string

Exceeds the maximum amount available for transfer.

-1160

string

Decimal precision error.

Wallet