On-chain Operations
Create a Transfer
Send assets from a source to a destination.
Request example
Response example
POST
/api/external/transactions/
Use a transfer when you already know the source, destination, blockchain, asset, and amount. You can estimate the network fee first. The returned status is the lifecycle source of truth.
Request body
The SDK accepts
chain and serializes it as blockChain. It injects category: "TRANSFER".Response
Returns the new Transaction. Itsstatus is the lifecycle source of truth.
Transaction ID. Use it with Retrieve Transaction to track status.
Lifecycle status. Track it until
COMPLETED, FAILED, or DECLINED. See TransactionStatus.See TransactionType.
For example
TRANSFER or CONTRACT_CALL. See TransactionCategory.Where the funds come from. Which fields are present depends on
type. See TransferPartyData.Where the funds go. Same fields as
source. See TransferPartyData.Approve the transaction
New transfers returnstatus: "PENDING" and wait for approval. Get the approval message for the transaction id, sign it with your API user’s key, then submit the approval. See Approvals.
With the SDK, createTransactionWithApproval(request) creates and approves in one call. createTransferTransaction(request) only creates.
Request example
Response example