# 划转

- **POST** ```/api/v3/wallet/transfer/self```

权重(IP): 20

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

<div class='api-content-wrap'>
<div>

<strong>请求体（Request Body）</strong>

| 参数名 | 参数类型 | 是否必须 | 描述 |
|:-------|:---------|:---------|:-----|
| amount | String | 是 | 划转数量，必须大于 0，精度不得超过币种配置精度，超出返回 -1160。 |
| fromAccountType | String | 是 | 划出账户类型：`UNIMARGIN`（合约账户）、`SPOT`（现货账户）、`FUNDING`（资金账户）。 |
| toAccountType | String | 是 | 划入账户类型，枚举同 `fromAccountType`，且不能与划出账户相同。 |
| coin | String | 是 | 币种编码。 |
| bizId | String | 否 | 业务 ID。传入时业务部分必须为 16-32 位 ASCII 字母或数字，可带 `openapi_` 前缀；无前缀时服务端自动补齐后存储和回传。不传时生成 openapi_ 加 32 位随机串。 |
| params | String | 否 | 业务备注或扩展说明。 |

</div>
<div class='api-align'>
  <div class='code-wrap'>

<strong>请求示例</strong>

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

</div>
  </div>
</div>

<div class='api-content-wrap'>
  <div>

<strong>返回参数</strong>

| 字段名 | 类型 | 字段说明 |
|:-------|:-----|:---------|
| code | Integer | 业务码，0 表示成功。 |
| msg | String | 响应信息。 |
| data.bizId | String | 实际使用的业务 ID。 |
| data.result | Boolean | `true` 表示划转成功。 |
| data.transferId | String | 划转 ID，有可能为 Null。 |

  </div>
  <div class='api-align'>
  <div class='code-wrap'>

<strong>返回示例</strong>

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "bizId": "openapi_NzqVr0AGj1uDYUp20260903102825",
    "result": true,
    "transferId": null
  }
}
```

</div>
    </div>
</div>

## 错误码

| 错误码 | Message |
|:---|:---|
| -2413 | Insufficient balance. |
| -2442 | Asset transfer failed. |
| -2443 | Asset transfer is processing. Retry with the same bizId. |
| -2444 | fromAccountType and toAccountType cannot be the same. |
| -2445 | bizId already exists. Reuse it only with the original request parameters. |
| -2446 | Legacy spot account is not supported. Use SPOT instead. |
| -2447 | bizId must contain 16 to 32 ASCII letters or digits, optionally prefixed with 'openapi_'. |
| -2452 | Exceeds the maximum amount available for transfer. |
| -1160 | Decimal precision error. |

其他钱包与前置校验错误见[钱包接口错误码](/products/wallet/WalletErrorCodes)。