Sign in

v1

latestOpenAPI 3.0.12026-07-24128351404.9 KB
Transfer

Intra-account business transfer

When to call this API  
Call /transfer/internal when the money stays inside the same platform account  
(same accountId) but moves between its sub-wallets/balances.  
Note: The minimum amount per CRYPTO_CONNECT transaction is 0.5 USD, USDC, or USDT.  
Example:  
- A company wants to shift 1,000 USD from its BUSINESS_ACCOUNT balance to its INFINITY_ACCOUNT balance  
- A user wants to move 0.5 USD from his CRYPTO_CONNECT wallet to his USD balance in BUSINESS_ACCOUNT
post/open-api/v3/business/transfer/internal

Request body

clientTransactionIdstring required

Idempotency key provided by the client to ensure uniqueness of the transfer request

accountIdstring uuid required

The UUID of the Account.

amountstring required

Total transfer amount (Including handling fees). Fraction digits depend on currency precision: USDC / USDT / WUSD: up to 6 decimal places; ETH / BTC: up to 8 decimal places; default to 2 decimal places.

Example request

{
  "clientTransactionId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
  "amount": "100",
  "from": {
    "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
    "currency": "USD",
    "businessType": 1
  },
  "to": {
    "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
    "currency": "USD",
    "businessType": 1
  }
}

Response

success

codestring

Business code, 000000 means success

messagestring

Message description

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "clientTransactionId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
    "id": "1965738216225083393",
    "createTime": "1768010400000",
    "completedTime": "1768010400000",
    "from": {
      "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
      "transferId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
      "parentAccountId": "dddaef0d-265f-484f-9b42-60175aa6f80e",
      "accountId": "a78b8771-5329-4829-88ce-7db14b3b1d0b",
      "amount": "100",
      "rate": "1",
      "currency": "USD",
      "businessType": 1,
      "fees": [
        {
          "amount": "10",
          "currency": "USD"
        }
      ]
    },
    "to": {
      "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
      "parentAccountId": "dddaef0d-265f-484f-9b42-60175aa6f80e",
      "accountId": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a524",
      "transferId": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a5253",
      "amount": "100",
      "currency": "USD",
      "businessType": 1,
      "fees": [
        {
          "amount": "10",
          "currency": "USD"
        }
      ]
    },
    "status": "CLOSED"
  }
}