API reference
Vaultody
POST
/vaults/{vaultId}/approximate-fee
Estimate Approximate Transaction Fee by Asset ID
Calculates an approximate fee by Asset ID for a planned transaction before it is submitted. This endpoint supports all transaction types: single transfer, multi transfer, gas sponsorship, and batch transfer. Use this endpoint to estimate costs and validate transaction feasibility prior to execution.
For each transaction type, the request body follows the same structure as the corresponding transaction endpoint, except for the Batch transaction. For Batch, the fields feePayer and feePayerAssetId are provided as top-level strings within the item object, rather than as nested objects.
Path parameters
vaultId
string
required
The unique identifier of the vault from which the transaction will originate.
Query parameters
context
string
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.
Body parameters application/json
context
string
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
amount
string
e.g. 0.001
Amount to transfer. Required for Single and Gas sponsorship transfers.
assetId
string
e.g. 6995822ce883e61317b3d6b6
The identifier of the asset to transfer. (Required for Single, Gas sponsorship and Multiple transfers).
feePayer
string
e.g. 0x0c3f01e4b2aae7c258f044c4cb64354f487abe...
Fee payer (sponsor) address . Required for Batch and Gas sponsorship transfers.
feePayerAssetId
string
e.g. 6995822ce883e61317b3d6b6
Asset ID of the fee payer . Required for Batch transfer.
feePriority
string
e.g. slow
Fee priority - slow, standard, fast. Not applicable for Tron and Solana.
slow
standard
fast
fromAddress
string
e.g. 0x463ebfb8eb88b41fd57952a407c14409fc0fb9...
Sender address. Required for Single, Batch and Gas sponsorship transfers.
method
string
e.g. transfer-from
Required when transaction_type is contractInteraction. The Tron contract method to invoke - approve or transfer-from.
approve
transfer-from
prepareStrategy
string
e.g. optimize_size
Strategy for preparing transaction - minimize_dust or optimize_size. (used for UTXO transactions).
minimize_dust
optimize_size
recipients
object[]
Destination addresses with amounts. Required for Multiple and Batch transfers.
address
string
e.g. 0x9e1046549484c5e17b00fb40beda0abbdf9cfc...
Address of the destination. Required for Multiple and Batch transfers.
amount
string
e.g. 0.001
Amount to transfer. Required for Multiple and Batch transfers.
assetId
string
e.g. 6995822ce883e61317b3d6b6
Asset ID for this destination. Required for Batch transfer, provide assetId inside each recipient object instead.
toAddress
string
e.g. 0xd2070342a1a5ce24930ec6582b3db846458525...
The recipient's address. Required for EVM transactions - Single and Gas sponsorship transfers.
transactionType
string
required
e.g. single
Type of transaction: single, multiple, batch. Gas sponsorship transfer use transactionType: single.
vaultAccountId
string
required
e.g. 69c28b729d1ca8000714911a
Sender's vault account ID.
Response
Returns 200 the request has been successful.
apiVersion
string
required
Specifies the version of the API that incorporates this endpoint.
requestId
string
required
Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.
context
string
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
errorMessage
string
required
The message of the error if such occurred.
feeInNative
string
required
The calculated fee.
maxAmount
string
required
For UTXO based transactions. The max amount you can send from the vault account.