Create Token Transaction Request
Through this endpoint users can make a single token transaction.
Path Parameters
Represents the specific blockchain protocol name.
Represents the name of the blockchain network used, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "sepolia" "nile" , "devnet" are test networks.
Defines the unique ID of the Vault.
Query Parameters
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
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.
Represents the specific amount of the transaction.
Contract address - for Bitcoin-based should be property id e.g 31 for EVM-based shoud be contract e.g 0xdac17f958d2ee523a2206206994597c13d831ec7.
This is required for all EVM-based blockchains, e.g Ethereum, Binance-Smart-Chain, Optimism, Polygon, Avalanche. This does not apply to Tron and Solana.
Defines the specific source address for the transaction.
The maximum allowable transaction fee set by the client. If the actual transaction fee exceeds this value, the transaction will not be processed.
Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.
Defines the specific recipient address for the transaction.
Response Schema
Specifies the version of the API that incorporates this endpoint.
Defines the ID of the request. The requestId is generated by Vaultody and it's unique for every request.
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.
Represents the fee priority of the transaction, whether it is "slow", "standard" or "fast".
Represents an optional note to add a free text in, explaining or providing additional detail on the transaction request.
Defines the destination for the transaction.
Defines the destination address.
Defines the amount sent to the destination address.
Represents the unit of the tokens amount recieved, e.g. USDT, USDC, JST.
Defines details about the source, i.e. the sender.
Defines the sender's public address.
Represents the specific token data.
Defines the contract address in the blockchain.
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.
Defines the status of the transaction, e.g. "created".
Callback parameters
Unique identifier of the wallet associated with the transaction.
Unique identifier of the webhook that triggered this callback.
A unique key used to prevent duplicate processing of this callback if it's sent more than once.
The version of the API that this webhook callback conforms.
Contains the event type and all related transaction information.
Type of webhook event: TRANSACTION_REQUEST indicates a new transaction request has been created and is pending approval or rejection.
Contains detailed metadata about the outgoing mined transaction
The name of the blockchain where the transaction was executed (e.g., ethereum, solana, tron).
The specific network of the blockchain, such as mainnet, testnet, sepolia, nile or devnet.
A unique identifier for the original transaction request that initiated this outgoing transaction.
The type of asset being transferred: COIN, TOKEN, LINKING, SMART_COIN, SMART_TOKEN, FREEZE, UNFREEZE, DELEGATE, UNDELEGATE, WITHDRAW_RESOURCE.
cb233681a8ee35665296c1824c1f67bc46691788
PSqeqRLap8rBc/wogNU1DeGGUPb2VyVtg6GiBOaBnYQ=
1681885776
zYgKeueoOq
{
"context": "yourExampleString",
"data": {
"item": {
"amount": "0.001",
"contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"feePriority": "slow",
"fromAddress": "0xd2070342a1a5ce24930ec6582b3db846458525a0",
"maxFee": "0.004",
"note": "yourAdditionalInformationhere",
"recipientAddress": "0x8deafae22f7dda381d1a8823c88d1df6df2c57f5"
}
}
}
{
"apiVersion": "2025-09-23",
"requestId": "601c1710034ed6d407996b30",
"context": "yourExampleString",
"data": {
"item": {
"feePriority": "slow",
"note": "yourAdditionalInformationhere",
"recipients": [
{
"address": "0xc6d46aba0c6e2eb6358c4e24804158cc4d847922",
"amount": "0.001",
"amountUnit": "USDC"
}
],
"senders": {
"address": "0x0902a667d6a3f287835e0a4593cae4167384abc6"
},
"tokenTypeSpecificData": {
"contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
},
"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"
}
}
}