Skip to main content
GET
Routing to a non-tokenized position

Query Parameters

chainId
number
default:1

Chain ID of the network to execute the transaction on

Example:

80094

fromAddress
string
required

Ethereum address of the wallet to send the transaction from

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

routingStrategy
enum<string> | null

Routing strategy to use. For this API, always use delegate in conjunction with a Smart Wallet.

Available options:
delegate,
delegate-legacy
tokenIn
string[]
required

Ethereum address of the token to swap from. For ETH, use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Example:
positionOut
string
required

Ethereum address of the position to receive

Example:

"0xf99be47baf0c22b7eb5eac42c8d91b9942dc7e84"

slippage
string
default:50

Slippage in basis points (1/10000), e.g. 50 = 0.50%. Takes precedence over minAmountOut.

Example:

"300"

fee
string[]

Fee in basis points (1/10000) for each amountIn value. Must be in range 1-100. By default the fee is collected from amountIn on the source chain. When destinationFeeReceiver is selected for destination execution, it is collected from the delivered bridge asset instead.

Example:
feeReceiver
string

The Ethereum address that receives the source-chain fee and remains the fallback when destination collection does not apply. Required if fee is provided.

Example:

"0x220866B1A2219f40e72f5c628B65D54268cA3A9D"

destinationFeeReceiver
string

Optional destination-chain fee receiver. For a cross-chain route with destination execution, the requested fee is collected atomically from the delivered bridge asset on the destination chain. Otherwise feeReceiver remains the source-chain receiver.

Example:

"0x220866B1A2219f40e72f5c628B65D54268cA3A9D"

amountIn
string[]
required

Amount of tokenIn to swap in wei

Example:
receiver
string
required

Ethereum address of the receiver of the positionOut

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

spender
string

Ethereum address of the spender of the tokenIn

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

referralCode
string

Referral code that will be included in an on-chain event.

Maximum string length: 16
Example:

"0123456789ABCDEF"

Response

gas
string
required
amountOut
string
required
priceImpact
number | null
required

Price impact in basis points, null if USD price not found

feeAmount
string[]
required

An array of the fee amount collected for each tokenIn

minAmountOut
string
required

The minimum allowable amount out after slippage

createdAt
number
required

Block number the transaction was created on

tx
object
required

The tx object to use in ethers

route
object[]
required

The route the shortcut will use

ensoFeeAmount
string[]
required
metadata
object
required
transactionCost
string | null

Point-in-time lower-bound estimate of mandatory source-chain transaction fees in the native token smallest unit. Excludes priority fees, transaction value, bridge fees, and destination execution.

transactionCostUsd
string | null

Decimal string USD value of transactionCost. Null when the native-token price or source-chain fee estimate is unavailable.

preTransactions
object[]

Transactions that may need to be executed before the main shortcut transaction. Token approvals should be skipped when the current allowance is already sufficient.