How Batch Transfers Work
Batch transfers follow a simple three-step process:- Create batch transfer – Submit a single request with multiple destination addresses and amounts
- Process batch – The system groups all transfers into a single blockchain transaction
- Execute transfers – All recipients receive their funds simultaneously in one transaction
Batch Processing
Batch transfers are processed as a single transaction on the blockchain, which means:- Cost Efficiency: Pay gas fees once for multiple transfers instead of per transfer
- Atomic Execution: All transfers succeed or fail together
- Faster Processing: Single transaction reduces blockchain congestion
- Simplified Tracking: One transaction hash for the entire batch
Request Structure
To create a batch transfer, send a POST request with the following structure:Batch
Batch
Each batch transfer destination includes the userId (ID of the user receiving funds), walletAddress (blockchain address receiving the transfer), and amount (the amount to transfer in human-readable format, e.g. “0.01” USDC).
Transaction Structure
When you create a batch transfer, the API response includes detailed information about the transaction:Source
Source
Destination
Destination
Receipt
Receipt
Transaction Status
Batch transfer transactions progress through several statuses:- CREATED: Transaction has been created and is awaiting processing
- PROCESSING: Batch transfer is being executed on the blockchain
- COMPLETED: All transfers in the batch have been successfully completed
- FAILED: Transaction failed (check
failedReason
for details)
Receipt Information
Thereceipt
object contains transaction details once completed:
- transactionHash: Blockchain transaction hash for the batch transfer
- userOpHash: User operation hash for account abstraction transactions