Sign in

v1

latestOpenAPI 3.0.02026-07-26103425558.9 KB
Crypto Transfer

Create a batch crypto transfer

Create a batch crypto transfer from a single wallet address to multiple wallet addresses among users.

post/v2/wallets/transfers/batches

Request body

requestIdstring uuid required
currency'usdc' | 'usdt' | 'usdg' | 'pyusd' required
chain'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'BASE' | 'BSC' | 'FLOW_EVM' | 'TRON' required
requireApprovalboolean

Whether this batch transfer requires approval before processing.

  • true: Transfer will enter approval workflow
  • false or omitted: Transfer proceeds immediately

Example request

{
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "usdc",
  "chain": "POLYGON",
  "source": {
    "userId": "a1f70737-3844-4782-a321-ad481108a8ec"
  },
  "destination": {
    "batch": [
      {
        "userId": "a1f70737-3844-4782-a321-ad481108a8ec",
        "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "amount": "0.01"
      }
    ]
  }
}

Response

Success

transferTypestring required

Example response

{
  "transferType": "WALLET.TRANSFER.BATCH",
  "transferDetails": {
    "id": "879af7af-67bf-469f-b718-d262a39d4857",
    "requestId": "14a84906-b72e-4847-b34d-51b9048fa6a5",
    "createdAt": "2025-04-05T00:55:50.609Z",
    "updatedAt": "2025-04-05T00:56:33.236Z",
    "chain": "POLYGON",
    "currency": "usdc",
    "contractAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
    "status": "COMPLETED",
    "source": {
      "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be",
      "walletAddress": "0x99a8c5ED386d217BC6ff0AA1b3585606D475432B",
      "walletType": "INDIVIDUAL"
    },
    "destination": {
      "batch": [
        {
          "amount": "0.04",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.05",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.06",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        },
        {
          "amount": "0.03",
          "userId": "6a13bd30-b3a3-4d44-af33-0b32e58261be"
        }
      ]
    },
    "receipt": {
      "transactionHash": "0x57f0cd3429ea425d982882243428ef4a1eda5f1be2157c1b34ea48b49b24fe7f",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
    }
  }
}