跳到主要内容

划转

  • POST /api/v3/wallet/transfer/self

权重(IP): 20

在当前认证用户自己的资金、现货 Pro 和合约账户之间划转资产,需要 TRANSFER 划转权限。用户身份来自 API Key 鉴权结果,不接受请求参数指定用户 UID。

请求参数

参数名参数类型是否必须描述
amountString划转数量,必须大于 0,不能小于现货币种信息接口中 withdrawMin 最小提币数量。
fromAccountTypeString划出账户类型:UNIMARGIN(合约账户)、SPOT(现货账户)、FUNDING(资金账户)。
toAccountTypeString划入账户类型,枚举同 fromAccountType,且不能与划出账户相同。
coinString币种编码。
bizIdString业务 ID。传入时业务部分必须为 16-32 位 ASCII 字母或数字,可带 openapi_ 前缀。
paramsString业务备注或扩展说明。

请求示例

{
"amount": "20",
"fromAccountType": "SPOT",
"toAccountType": "FUNDING",
"coin": "USDT",
"params": "test",
"bizId": "openapi_NzqVr0AGj1uDYUp20260903102825"
}

返回参数

字段名类型字段说明
codeInteger业务码,0 表示成功。
msgString响应信息。
data.bizIdString实际使用的业务 ID。
data.resultBooleantrue 表示划转成功。
data.transferIdString划转 ID,有可能为 Null。

返回示例

{
"code": 0,
"msg": "success",
"data": {
"bizId": "SELFTRANSFER202609020001",
"result": true,
"transferId": null
}
}