> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Internal Transfer (SIGNED)

`Initiate an internal transfer (following the existing internal withdraw process).`

#### Request URL

`POST https://cloud-api.wooxpro.com/transfer/transfer-gateway/private/internalTransfer`

#### Request Limit

See [Detailed Rate Limit](/english/rate-limit)

#### Request Parameter

> Request

```shell theme={null}
curl
 -H 'X-API-KEY:{{AccessKey}}'
 -H 'X-API-TIMESTAMP:{{currentTime}}'
 -H 'X-API-SIGN:{{SIGN}}'
 -X POST -d '{
  "uid":"123456",
  "coin":"USDT",
  "amount":10.5,
  "accountType":"SPOT"
}'
https://cloud-api.wooxpro.com/transfer/transfer-gateway/private/internalTransfer
```

| Field       | Type   | Required? | Description                                                                                                                      |
| :---------- | :----- | :-------- | :------------------------------------------------------------------------------------------------------------------------------- |
| uid         | String | Yes       | Recipient userId (string format numeric); cannot be blank                                                                        |
| coin        | String | Yes       | Currency code abbreviation (e.g., USDT, BTC)                                                                                     |
| amount      | Number | Yes       | Amount; must be > 0                                                                                                              |
| accountType | String | Yes       | CONTRACT is not supported; if the environment does not support a fund account, only SPOT is allowed (e.g., SPOT, FUND, CONTRACT) |

#### Response Data

> Response

```json theme={null}
{
  "code": 1000,
  "message": "Ok",
  "trace": "0cc6f4c48b8c42538e908d3195aa109c",
  "data": {
    "id": "withdrawId"
  }
}
```

| Field | Type   | Description           |
| :---- | :----- | :-------------------- |
| id    | String | Transfer operation ID |

#### Error Codes

> Note: These error codes will be updated in a future version.

| errMsg                                                     |   code  |
| :--------------------------------------------------------- | :-----: |
| Ok                                                         |   1000  |
| Failure                                                    |    -1   |
| Invalid request                                            |    -3   |
| User not login                                             |    -6   |
| Balance not enough                                         |  -2105  |
| Sub-account does not support withdraw                      |  -2112  |
| Internal Withdraw forbidden                                |  -2302  |
| The withdrawal user and the target user cannot be the same |   3014  |
| toUserCid is not in agent system.                          | -1 / -3 |
| You are not an invited user.                               |    -1   |