Transfers

Transfers allow you to initiate and complete fund movements between internal or external accounts. These endpoints enable secure, auditable transfers that support multiple stages such as initiation and finalization.

Use the following endpoints to manage your transfer workflows:

Transfer API Endpoints

Transfer Request Payload Schema

to_addressstringRequired

The recipient's blockchain address where funds will be sent. Must be a valid address for the specified chain.

amountstringRequired

Amount of the asset to transfer, expressed in smallest units (e.g., 1 USDC = 1,000,000 units).

currencystringRequired

Asset being transferred (e.g., 'USDC', 'USDT','BTC').

chainstringRequired

Blockchain network where the transfer will occur (e.g., 'ethereum', 'bsc', 'polygon').

referencestringNot Required

A unique external identifier for tracking and ensuring idempotent transaction submission.

descriptionstringNot Required

An optional note or memo describing the purpose of the transfer.

Request Body

Transfer Response

successboolean

Indicates whether the API request was processed successfully.

messagestring

A human-readable message describing the result of the transfer operation.

transaction_idstring (UUID)

A unique identifier generated to track and reference this blockchain transaction.

statusstring

Shows the current state of the transaction in its lifecycle (e.g., pending, completed, failed).

addressstring

The destination blockchain wallet address where the funds are being sent.

amountstring

The numeric value of the cryptocurrency being transferred in the smallest unit.

currencystring

The symbol of the digital asset being transferred (e.g., USDC, USDT, BTC).

chainstring

Specifies the blockchain used to process the transaction (e.g., bsc, ethereum, solana).

networkstring

Indicates whether the transaction is running on a live network or a test environment.

referencestring

A custom reference value provided by the client to help with internal tracking and reconciliation.

created_atstring (ISO 8601)

The exact date and time when the transaction was created.

descriptionstring

An optional note or memo describing the purpose of the transfer.

request_idstring

A unique identifier for this specific API request, useful for debugging and support.

timestampstring (ISO 8601)

The UTC timestamp when the response was generated.

Transfer Response