Skip to main content
POST
Get transaction data for execution
Returns the transaction data for a swap. Sign it with the user’s wallet and broadcast it.
fromChain
number
required
Source chain ID (e.g., 1 for Ethereum, 8453 for Base, 369 for PulseChain).
toChain
number
required
Destination chain ID.
fromToken
string
required
Source token contract address. Use 0x0000000000000000000000000000000000000000 for native tokens (ETH, PLS, etc.).
toToken
string
required
Destination token contract address.
fromAmount
string
required
Amount in the smallest unit (e.g., wei). Must be a string to handle large numbers.
fromAddress
string
required
Sender wallet address.
toAddress
string
required
Recipient wallet address on the destination chain.
slippage
number
Maximum slippage as a decimal (e.g., 0.03 for 3%). Default: 0.03.
tool
string
Specific routing tool. Omit to let Hypermid choose the best automatically.
depositMode
string
Set to "manual" to force manual deposit flow for non-EVM chains.

Response Types

The response has one of two shapes depending on the route:

Transaction Request (most swaps)

Sign it and broadcast.
ERC20 input? Approve estimate.approvalAddress (not transactionRequest.to) first. On wallets that support EIP-7702 / EIP-5792 you can collapse the approval and the swap into a single tap — see the 1-Tap Approve + Swap guide.

Deposit Address (XRP, Dogecoin, Stellar, etc.)

Show the address to the user. They send tokens from their native wallet.
Track deposit-based swaps with GET /v1/execute/deposit/status.
Some PulseChain routes require a confirmation step after the transaction. If the quote response includes afterStep1, see Register — Inbound Receiver.
Transaction data is time-sensitive. Sign and broadcast within a few minutes — prices and gas estimates change.

Authorizations

X-API-Key
string
header
required

Partner API key. Optional for public endpoints, required for /v1/partner/*.

Body

application/json
fromChain
integer
required

Source chain ID

fromToken
string
required

Source token address

fromAmount
string
required

Amount in base units

toChain
integer
required

Destination chain ID

toToken
string
required

Destination token address

fromAddress
string
required

Sender wallet address

toAddress
string
required

Recipient wallet address

refundAddress
string

Refund address (defaults to fromAddress)

slippage
number

Slippage tolerance (decimal or bps)

Response

Execution data with deposit address

data
object
required

Response payload (null on error)

error
object | null
required
meta
object
required