API reference Vaultody

POST /vaults/{vaultId}/transaction-requests/batch

Create Batch Transaction Request

Creates a batch transaction request that groups multiple asset transfers into a single EIP-7702–compliant transaction. The batch supports multiple recipient transfers initiated from a single sender and sponsored by a designated fee payer, enabling all operations to execute automically on supported EVM blockchains - Ethereum, Binance Smart Chain, Optimism, Base, Arbitrum, Polygon.

Path parameters

vaultId string required

Sender's Vault ID.

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

data object required

item object required

feePayer object required

Fee payer data used to resolve blockchain/network

address string required e.g. 0xa5bd60af2ed1499ce8292bb2e6c0179dcea34f...

Address responsible for paying transaction fees.

assetId string required e.g. 6913471c6b2794841dc8fb7e

Asset used to pay gas fees.

feePriority string required e.g. slow

Fee priority of the transaction - slow, standard, fast

slow standard fast

fromAddress string required e.g. 0x9b08125f3fb134f0ebb462ccff0f463bcfb4f6...

Address initiating the batch transaction.

note string required e.g. yourAdditionalInformationhere

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

recipients object[] required

Destination of the transaction.

address string required e.g. 0xd2070342a1a5ce24930ec6582b3db846458525...

Recipient address for the transfer.

amount string required e.g. 0.001

Amount to transfer.

assetId string required e.g. 6913471c6b2794841dc8fb7e

Asset identifier being transferred.

vaultAccountId string e.g. 68dfae9739a4b80007c4f706

Unique identifier of the Vault Account.

Response

Returns 201 the request has been successful.

apiVersion string required

Specifies the version of the API that incorporates this endpoint.

E.G. 2026-03-20

requestId string required

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

E.G. 601c1710034ed6d407996b30

context string

E.G. yourExampleString

data object required

item object required

amountUnit string required

Indicates the unit in which the transaction amount is expressed.

E.G. ETH

feePayer string required

Address that will cover for the fee.

E.G. 0xa5bd60af2ed1499ce8292bb2e6c0179dcea34f33

feePriority string required

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

slow standard fast

E.G. slow

note string required

Transaction note with additional details.

E.G. yourAdditionalInformationhere

recipients object[] required

Destination of the transaction.

address string required

Address of the destination.

E.G. 0xd2070342a1a5ce24930ec6582b3db846458525a0

amount string required

Defines the amount sent to the destination address.

E.G. 0.001

amountUnit string required

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

E.G. ETH

assetId string required

Asset identifier being transferred.

E.G. 6913471c6b2794841dc8fb7e

convertedAmountToUSD string required

Amount calculated in USD.

E.G. 3.31

senders object required

Source of the transaction,

address string required

Addresses of the sources

E.G. 0x9b08125f3fb134f0ebb462ccff0f463bcfb4f623

totalTransactionAmountInUsd string required

Total amount of the transaction in USD.

E.G. 3.31

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.

E.G. 6980695689a82e0ff4f7edc7

transactionRequestStatus string required

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

created await-approval pending prepared signed broadcasted success failed rejected mined mined-with-errors await-approval-l2 +1

E.G. created

Errors

400 The pagination attributes that have been used are invalid. Please check the Documentation to see details on pagination. application/json

401 The provided API key is invalid. Please, generate a new one from your Dashboard. application/json

403 This wallet is not for the provided network. application/json

409 The token is not supported for this blockchain and network. To be supported, please contact our team. application/json

415 The selected Media Type is unavailable. The Content-Type header should be 'application/json'. application/json

422 Your request body for POST requests must have a structure of { data: { item: [...properties] } } application/json

429 The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan. application/json

500 An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email. application/json