Jump to
Ctrl
+
/

Create Coin Transaction Request

POST
/vaults/{vaultId}/{blockchain}/{network}/transaction-requests

Through this endpoint users can make transaction requests for various blockchain types, including EVM-based, UTXO-based, Tron, and Solana blockchains.

Path Parameters

blockchain string Required

Blockchain string full name representation (eg. bitcoin, ethereum, solana, tron).

network string Required

Network string full name representation (eg. mainnet, testnet).

vaultId string Required

Sender's Vault ID.

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

Request Body Schema application/json

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

data object Required
item object Required
feePriority string Optional

Fee priority of the transaction - slow, standard, fast. Not applicable for Tron and Solana.

maxFee string Optional

The maximum allowable transaction fee set by the client. If the actual transaction fee exceeds this value, the transaction will not be processed.

note string Required

Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.

prepareStrategy string Optional

Refers to a model of a UTXO spending strategy, where customers can choose how to spend their transaction outputs from multiple Bitcoin addresses. Two options available - "minimize-dust" (select lower amounts from multiple addresses) or "optimize-size" (select higher amounts from less addresses). Not applicable for EVM-based, Tron and Solana blockchains.

recipients array Items (object) Required

Destination of the transaction.

address string Required

Destination address. For XRP transactions, if the address belongs to the XRP Ledger, and a destinationTag is required, the address must be provided in the X-Address format.

amount string Required

Destination amount.

senders array Items (object) Optional

Required for EVM-based transactions. Not applicable for UTXO-based transactions.

address string Optional

Required for EVM-based transactions, Tron and Solana. For XRP transactions, if the address belongs to the XRP Ledger, and a sourceTag is required, the address must be provided in the X-Address format.

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2025-09-23
requestId string Required

Defines the ID of the request. The requestId is generated by Vaultody and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
item object Required
addressTag integer Optional

Defines a specific Tag that is an additional XRP address feature. It helps identify a transaction recipient beyond a wallet address. The tag that was encoded into the x-Address along with the Source Classic Address.

12345
classicAddress string Optional

Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the source address is an x-Address.

rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z
feePriority string Optional

Fee priority of the transaction - slow, standard, fast.

slow
maxFee string Optional

The maximum allowable transaction fee set by the client. If the actual transaction fee exceeds this value, the transaction will not be processed.

0.001
note string Required

Transaction note with additional details.

yourAdditionalInformationhere
recipients array Items (object) Required

Destination of the transaction.

address string Required

Address of the destination.

0x8deafae22f7dda381d1a8823c88d1df6df2c57f5
addressTag integer Optional

Defines a specific Tag that is an additional XRP address feature. It helps identify a transaction recipient beyond a wallet address. The tag that was encoded into the x-Address.

3999472835
amount string Required

Defines the amount sent to the destination address.

0.001
amountUnit string Required

Defines the unit of the received amount for the address, e.g. ETH, BTC, TRX, BNB.

ETH
classicAddress string Optional

Represents the public address, which is a compressed and shortened form of a public key. The classic address is shown when the destinations address is an x-Address.

rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z
senders object Required

Defines details about the source, i.e. the sender.

address string Optional

Required for EVM-based transactions, Tron, and Solana. Not applicable for UTXO-based transactions.

0xd2070342a1a5ce24930ec6582b3db846458525a0
totalTransactionAmount string Required

Total amount of the transaction.

0.001
transactionRequestId string Required

Represents a unique identifier of the transaction request (the request sent to make a transaction), which helps in identifying which callback and which referenceId concern that specific transaction request.

62daacdbc8a7282e9ea01c35
transactionRequestStatus string Required

Defines the status of the transaction, e.g. "created".

created

Callback parameters

walletId string Required

Unique identifier of the wallet associated with the transaction.

685121237d7d1e0007ac1a1d
webhookId string Required

Unique identifier of the webhook that triggered this callback.

68516e9c6620b0a4790ed541
idempotencyKey string Required

A unique key used to prevent duplicate processing of this callback if it's sent more than once.

928fe1786859b5e33a2f63c569a0351e0c90cbe35bc5a7bb0bb1523cd371dda9
apiVersion string Required

The version of the API that this webhook callback conforms.

2025-09-23
data object Required

Contains the event type and all related transaction information.

event string Required

Type of webhook event: TRANSACTION_REQUEST indicates a new transaction request has been created and is pending approval or rejection.

TRANSACTION_REQUEST
item object Required

Contains detailed metadata about the outgoing mined transaction

blockchain string Required

The name of the blockchain where the transaction was executed (e.g., ethereum, solana, tron).

ethereum
network string Required

The specific network of the blockchain, such as mainnet, testnet, sepolia, nile or devnet.

mainnet
requestId string Required

A unique identifier for the original transaction request that initiated this outgoing transaction.

686cd2860ca2f4fd25f77099
transactionType string Required

The type of asset being transferred: COIN, TOKEN, LINKING, SMART_COIN, SMART_TOKEN, FREEZE, UNFREEZE, DELEGATE, UNDELEGATE, WITHDRAW_RESOURCE.

COIN
Was this page helpful?
Yes
No
Powered by
Language
URL

{
    "apiVersion": "2025-09-23",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "item": {
            "addressTag": 12345,
            "classicAddress": "rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z",
            "feePriority": "slow",
            "maxFee": "0.001",
            "note": "yourAdditionalInformationhere",
            "recipients": [
                {
                    "address": "0x8deafae22f7dda381d1a8823c88d1df6df2c57f5",
                    "addressTag": 3999472835,
                    "amount": "0.001",
                    "amountUnit": "ETH",
                    "classicAddress": "rA9bXGJcXvZKaWofrRphdJsBWzhyCfH3z"
                }
            ],
            "senders": {
                "address": "0xd2070342a1a5ce24930ec6582b3db846458525a0"
            },
            "totalTransactionAmount": "0.001",
            "transactionRequestId": "62daacdbc8a7282e9ea01c35",
            "transactionRequestStatus": "created"
        }
    }
}
{
    "walletId": "685121237d7d1e0007ac1a1d",
    "webhookId": "68516e9c6620b0a4790ed541",
    "idempotencyKey": "928fe1786859b5e33a2f63c569a0351e0c90cbe35bc5a7bb0bb1523cd371dda9",
    "apiVersion": "2025-09-23",
    "data": {
        "event": "TRANSACTION_REQUEST",
        "item": {
            "blockchain": "ethereum",
            "network": "mainnet",
            "requestId": "686cd2860ca2f4fd25f77099",
            "transactionType": "COIN"
        }
    }
}