# 5、Add Transfer Order
Request Method
- POST
Request URL
/api/v3/wallet/transfer
Request Header
Content-Type: application/json;charset=utf-8
Request Header Parameters
| Parameter Name | Type | Description | Example Value |
|---|---|---|---|
| access_key | String | Obtained from the merchant's backend | pFqV75X3 |
| timestamp | int64 | 13-digit timestamp (milliseconds) | 1679724896223 |
| nonce | String | Random string (UUID V4) | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
| sign | String | Signature generated using the secret key | kAXyh+eerqrefyaF8dyFB0M4FVo= |
Request Parameters (JSON)
{
"externalOrderId": "622257420681202921",
"addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
"chainType": "ETH",
"tokenType": "USDT",
"currencyType": "USD",
"cryptoAmount": "1",
"notifyUrl": "http://192.168.1.135:30002/url",
"remark": "http://192.168.1.135:30002/url"
}
Parameter Description
| Parameter Name | Type | Description | Required |
|---|---|---|---|
| externalOrderId | String | Merchant Order ID (maximum 64 characters) | ✅ Yes |
| addressTo | String | Receiving wallet address (maximum 64 characters) | ✅ Yes |
| chainType | String | Blockchain type:TRON BSC ETH | ✅ Yes |
| tokenType | String | Cryptocurrency type, enum values: USDT USDC PEPE DOGE PUSD | ✅ Yes |
| cryptoAmount | String | Cryptocurrency amount, based on token precision (either this or currencyAmount) | ❌ No |
| currencyType | String | Fiat currency type (USD, BRL, etc.) | ❌ No |
| currencyAmount | String | Fiat amount, up to two decimal places (either this or cryptoAmount; calculated based on the current exchange rate) | ❌ No |
| notifyUrl | String | Callback URL | ❌ No |
| remark | String | Remark information, max length 1024 characters | ❌ No |
Response Type
Header: {
"Content-Type": "application/json;charset=utf-8"
}
Response Example
{
"code": "200",
"success": true,
"msg": "成功",
"msgEn": "SUCCESS",
"data": {
"orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
"orderStatus": "Accepted",
"addressTo": "0xa8666442fA7583324324169CC9F5449ec660295E8",
"chainType": "ETH",
"tokenType": "USDT",
"tokenAmount": 1,
"externalOrderId": "622257420681202921"
}
}
Response Parameter Description
| Parameter Name | Type | Description |
|---|---|---|
| orderId | String | Platform Order ID |
| orderStatus | String | Order status (e.g., Accepted) |
| addressTo | String | Receiving address |
| chainType | String | Blockchain type |
| tokenType | String | Cryptocurrency type |
| tokenAmount | float64 | Cryptocurrency amount |
| externalOrderId | String | Merchant Order ID |