Set your transfer parameters
Before you can send tokens or messages, you'll need to set your parameters.
Now you're ready to set the parameters of your trade request.
Example 1: [EVM -> Cosmos] Swap 0.1 Native AVAX from Avalanche Fuji Tesntet and receive Noble USDC on the Osmosis Testnet
Example 2: [Cosmos -> EVM] Swap 1 nUSDC from Osmosis Testnet and receive Native AVAX Avalanche Fuji Tesntet
Example 3: [Cosmos -> Cosmos] Swap 1 uosmo from Osmosis Testnet and receive nUSDC on Omosis Testnet
Due to low liquidity on testnet, we ask that you limit your trade size in most cases to less than 0.1 of the native gas token (e.g. <0.1 ETH, or AVAX).
Note that the same token types (i.e. USDC) often has a different address on each chain. Make sure you've checked the address is right for the chain you are sending from/to.
Params are structured as a#getroute object. A GetRoute
object describes a desired any-to-any transfer. It is defined by the following interface:
Request Params:
Property | Description |
---|---|
fromChain | |
fromToken | |
fromAmount | Amount of tokens to be sent (in EVM wei or "u" Cosmos micro units) |
toChain | |
toToken | |
fromAddress | Fallback address for the EVM or Cosmos part of the trade. Must be set when executing swaps from EVM to/from Cosmos |
toAddress | The recipient address to receive the tokens |
slippage | Max slippage across route, (0.3-99.99) 1 = 1% slippage. |
quoteOnly (optional) | If |
prefer (optional) | When set, the route response will prefer routes from the DEX corresponding to the string. See possible strings here. EVM chains only supported. |
collectFees | Integrators can pass in a wallet address and a fee percentage - see fees section |
Sending/receiving native tokens (EVM chains only)
If you want to send or receive native tokens (i.e ETH), the sourceTokenAddress
or destinationTokenAddress
arguments must be set to 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
Once you have configured the params object, the next step is to get a route
Last updated