'/%3e%3cdefs%3e%3cpattern%20id='pattern0_2104_4598'%20patternContentUnits='objectBoundingBox'%20width='1'%20height='1'%3e%3cuse%20xlink:href='%23image0_2104_4598'%20transform='matrix(0.00376176%200%200%200.0172414%20-0.00219436%200)'/%3e%3c/pattern%3e%3cimage%20id='image0_2104_4598'%20width='267'%20height='58'%20preserveAspectRatio='none'%20xlink:href='data:image/png;base64,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'/%3e%3c/defs%3e%3c/svg%3e)
Bulk Transfers
The Bulk Transfers API allows you to send multiple crypto transfers in a single batch. Upload a CSV or spreadsheet, preview the parsed items, create a draft, confirm execution, and retry failed items. You can also schedule recurring bulk transfers using templates.
Upload Preview
Use Case
Upload a CSV or XLSX file to preview the parsed transfer items before creating a batch. The response separates valid items from rows with errors, allowing you to review and correct before submission.
Request
Content type must be multipart/form-data.
CSV or XLSX file containing transfer rows with columns for chain, currency, address, amount, and an optional description. Maximum file size: 5MB.
Response Body
The preview response separates valid items from invalid rows, giving you a chance to review before creating a batch.
Array of successfully parsed transfer items from the uploaded file.
1-based row number corresponding to the row in the uploaded file.
The blockchain network for the transfer (e.g., 'bitcoin', 'tron', 'ethereum').
Currency code for the transfer: BTC, USDT, or USDC. Must match a supported currency on the specified chain.
Recipient wallet address. Must be valid for the specified chain.
Transfer amount as a decimal string (e.g., '0.001' for BTC, '1500.00' for USDT).
Optional memo or label for the transfer item.
Array of rows that failed validation, each with the row number, address, and rejection reason.
1-based row number of the invalid row in the uploaded file.
The wallet address from the invalid row as it appeared in the uploaded file.
Reason the row failed validation (e.g., 'Invalid Bitcoin address format', 'Unsupported currency').
Number of rows that passed validation.
Number of rows that failed validation.
Create Bulk Transfer Draft
Use Case
Creates a new bulk transfer batch in draft status from an array of transfer items. The batch must be confirmed before any transfers are executed.
Request Body
Include the transfer items and optional batch-level settings in the request body.
Batch description for internal identification (e.g., 'March 2026 Payroll').
Array of transfer items to include in the batch, each requiring at minimum chain, currency, address, and amount.
Optional 1-based row number mapping this item back to its source file row, echoed in the response.
The blockchain network for the transfer (e.g., 'bitcoin', 'tron', 'ethereum').
Currency code for the transfer: BTC, USDT, or USDC. Must match a supported currency on the specified chain.
Recipient wallet address. Must be valid for the specified chain.
Transfer amount as a decimal string (e.g., '0.001' for BTC, '1500.00' for USDT).
Optional memo or label for the transfer item.
If true, valid items are processed even if some fail validation.
Client-provided key to prevent duplicate batch creation.
Response Body
The response includes the created batch and its items with their initial statuses.
Unique identifier (UUID) for the batch.
Identifier of the company account that owns this batch.
Batch description for internal identification.
Current batch status: draft, pending, processing, completed, failed, or cancelled.
Total number of items in the batch.
Number of items successfully completed.
Number of items that failed.
ISO 8601 timestamp when the batch was created.
ISO 8601 timestamp when the batch was confirmed. Empty if still in draft.
ISO 8601 timestamp when all items finished processing. Empty if the batch has not yet completed.
Array of transfer item objects belonging to this batch.
Unique identifier (UUID) for this individual transfer item within the batch.
Item status: pending, processing, confirmed, or failed.
Reason the item failed. Empty if not failed.
Number of retry attempts for this item.
Associated withdrawal ID once processed. Empty if not yet processed.
List Bulk Transfers
Use Case
Retrieves all bulk transfer batches with optional filtering and pagination. Use this to display batch history, monitor processing status, or search for specific batches.
Response Body
Returns a paginated list of batches matching your filters, each with its processing status and item counts.
Array of bulk transfer batch objects matching the requested filters.
Cursor token for the next page of results. Empty when on the last page.
The response body is identical to that of Create Bulk Transfer Draft. Refer to the Create Draft Response section for field explanations.
Get Bulk Transfer
Use Case
Retrieves a specific bulk transfer batch along with all its items. Use this to check the status of individual transfers within a batch and identify any failed items.
Path Parameters
Specify the batch ID to retrieve.
UUID of the bulk transfer batch to retrieve.
Response Body
Returns the full batch object including all transfer items and their individual statuses.
The response is identical to that of Create Bulk Transfer Draft. Refer to the Create Draft Response section for field explanations.
Confirm Bulk Transfer
Use Case
Confirms a draft batch and initiates execution of all transfers. This is an irreversible action — once confirmed, the transfers will begin processing.
Path Parameters
Specify the batch ID to confirm.
UUID of the draft batch to confirm. The batch must be in 'draft' status.
Response Body
The response confirms the batch has moved to processing status.
Unique identifier (UUID) for the batch.
Current batch status: draft, pending, processing, completed, failed, or cancelled.
ISO 8601 timestamp when the batch was confirmed.
Retry Failed Items
Use Case
Retries specific failed items in a batch. Use this after resolving the issue that caused the failure (e.g., topping up your balance) to re-process only the items that need it.
Path Parameters
Specify the batch containing the failed items.
UUID of the batch containing the failed items to retry.
Request Body
Provide the IDs of the specific items you want to retry.
Array of UUIDs identifying the specific failed items to retry. Only items with 'failed' status will be re-queued.
Response Body
The response shows the retried items with their updated status and retry count.
Unique identifier (UUID) for the batch.
Current batch status: draft, pending, processing, completed, failed, or cancelled.
Array of the transfer items submitted for retry with their updated status and retry count.
Unique identifier (UUID) for this individual transfer item.
Item status: pending, processing, confirmed, or failed.
Number of retry attempts for this item.