Build Transaction Request

post

https://api-wallet-sandbox.venly.io/api/transactions/build

Transforms a generic transaction request into a blockchain-specific transaction with all necessary parameters populated for the target network.

What this endpoint does:

Validates transaction data against the specified blockchain network
Converts generic amounts to blockchain-native units (e.g., 0.1 SUI → 100000000 MIST)
Calculates and populates network-specific parameters (gas price, gas budget, nonce)
Transforms generic transaction types to chain-specific types (TRANSFER → SUI_TRANSFER)
Returns a structured transaction request ready for confirmation and execution

Supported transaction types:

Native transfers: Send blockchain's native currency (ETH, SUI, MATIC, etc.)
Token transfers: Send ERC-20 or equivalent tokens
NFT transfers: Transfer ERC-721/ERC-1155 or equivalent NFTs
Contract execution: Call smart contract functions
Multi-transfers: Batch multiple operations (Hedera only)

Body Params

walletId

string

required

The wallet ID that will execute the transaction

string

The destination wallet address

secretType

string

enum

required

The blockchain of the transaction

type

string

enum

required

The type of transfer.

Allowed:

functionName

string

required

The name of the function you want to call

value

number

inputs

array of objects

Array of inputs needed to call the function

inputs

chainSpecificFields

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Transaction prepared for a specific chain successfully.

400Request validation failed (400)

401Authentication required or failed (401)

403User lacks required permissions (403)

404Resource not found (404)

405HTTP method not supported (405)

415Request body is not valid JSON or wrong media type (415)

500Unexpected server error (500)