Swap Documentation

API reference for Actions SDK swap operations, functions, and parameters.

WalletSwapNamespace

Wallet swap namespace with full operations including signing. Provides getQuote() for pricing and execute() for swapping tokens.

Methods

Function	Description
supportedChainIds()	Union of chain IDs supported by any configured provider.
getQuote()	Get a swap quote bound to the wallet as executor. Defaults the output recipient to the wallet address when omitted.
getQuotes()	Get quotes from all providers bound to the wallet as executor.
getMarket()	Get a specific swap market by ID.
getMarkets()	Get available swap markets across all providers
execute()	Execute a token swap. Accepts either raw params (re-quotes internally) or a pre-built SwapQuote (skips re-quoting). When a pre-built quote is passed, its wallet address must equal this wallet’s address so approvals are checked against the account that will execute the swap. Re-quote via wallet.swap.getQuote(...) to bind the quote to this wallet.

supportedChainIds()

Union of chain IDs supported by any configured provider.

_{Source ↗}

---

getQuote()

Get a swap quote bound to the wallet as executor. Defaults the output recipient to the wallet address when omitted.

Parameter	Type	Description
params	SwapQuoteParams

_{Source ↗}

---

getQuotes()

Get quotes from all providers bound to the wallet as executor.

Parameter	Type	Description
params	SwapQuoteParams

_{Source ↗}

---

getMarket()

Get a specific swap market by ID.

Parameter	Type	Description
params	GetSwapMarketParams	Market identifier (poolId + chainId)
provider	SwapProviderName	Optional provider name to query directly instead of searching all

Returns: Market information

_{Source ↗}

---

getMarkets()

Get available swap markets across all providers

Parameter	Type	Description
params	GetSwapMarketsParams	Optional filtering by chainId or asset

Returns: Promise resolving to array of markets from all providers

_{Source ↗}

---

execute()

Execute a token swap. Accepts either raw params (re-quotes internally) or a pre-built SwapQuote (skips re-quoting). When a pre-built quote is passed, its wallet address must equal this wallet’s address so approvals are checked against the account that will execute the swap. Re-quote via wallet.swap.getQuote(...) to bind the quote to this wallet.

Parameter	Type	Description
params	`WalletSwapParams	SwapQuote`	Swap parameters or a pre-built SwapQuote from getQuote()

Returns: Swap receipt with transaction details

_{Source ↗}

---