1inch DEX Aggregator

Swap tokens on EVM networks using the 1inch DEX aggregator. 1inch finds the best swap route across DEXes (Uniswap, SushiSwap, Curve, Balancer, etc.) to get the best price. This is Classic Swap mode where the user pays gas directly.

Supported Networks: Ethereum, Arbitrum, Base, Optimism, Polygon, BSC, Avalanche, Gnosis.

IMPORTANT: All tools require a chain parameter. Always ask the user which network they want to use before proceeding. Do not assume a default chain.

Default for spot token swaps. Use 1inch for buying/selling/swapping tokens. 1inch aggregates liquidity across all major DEXes to get the best price. Hyperliquid spot is only for tokens listed on Hyperliquid's own orderbook — for general spot trading across chains.

Prerequisites — Wallet Policy

Before executing any swap, the wallet policy must be active. Load the wallet-policy skill and propose the standard wildcard policy (deny key export + allow *). This covers all 1inch operations — swap transactions, token approvals, and signing — across all chains.

Available Tools (8)

Same-Chain Read-Only Tools

Same-Chain Write Tools (require wallet)

Cross-Chain Tools (Fusion+)

Fusion+ enables gasless cross-chain swaps using intent-based atomic swaps. Resolvers handle gas on both chains.

Tool Usage Examples

Get a quote (price check only)

oneinch_quote(
  chain="arbitrum",
  src="0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  # ETH
  dst="<USDC_ADDRESS>",                                  # use oneinch_tokens to find
  amount="1000000000000000000"                            # 1 ETH in wei
)

Search for a token

oneinch_tokens(chain="ethereum", search="USDC")

Check if approval is needed

oneinch_check_allowance(chain="arbitrum", token_address="<TOKEN_ADDRESS>")

Approve a token

oneinch_approve(chain="arbitrum", token_address="<TOKEN_ADDRESS>")

Execute a swap

oneinch_swap(
  chain="arbitrum",
  src="0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  # ETH
  dst="<USDC_ADDRESS>",                                  # use oneinch_tokens to find
  amount="1000000000000000000",                           # 1 ETH
  slippage=1.0                                            # 1% slippage
)

Cross-Chain: Get a quote

oneinch_cross_chain_quote(
  src_chain="ethereum",
  dst_chain="arbitrum",
  src_token="0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",  # ETH on Ethereum
  dst_token="<USDC_ADDRESS>",                                  # USDC on Arbitrum
  amount="1000000000000000000"                                  # 1 ETH in wei
)

Cross-Chain: Execute a swap (recommend background task)

sessions_spawn(
  message="Execute cross-chain swap: oneinch_cross_chain_swap(src_chain='ethereum', dst_chain='arbitrum', src_token='0xEeee...EEeE', dst_token='<USDC_ADDR>', amount='1000000000000000000', preset='medium')"
)

Cross-Chain: Check order status

oneinch_cross_chain_status(order_hash="<ORDER_HASH>")

Common Workflows

Step 0 for all workflows: If the wallet policy is not yet active, load the wallet-policy skill and propose the standard wildcard policy before proceeding.

Swap native ETH for USDC (no approval needed)

1. Find token address: oneinch_tokens(chain="arbitrum", search="USDC") — get the USDC address on Arbitrum
2. Quote: oneinch_quote(chain="arbitrum", src="0xEeee...EEeE", dst="<USDC_ADDR>", amount="1000000000000000000")
3. Swap: oneinch_swap(chain="arbitrum", src="0xEeee...EEeE", dst="<USDC_ADDR>", amount="1000000000000000000")

Native ETH does not require token approval.

Swap USDC for WETH (approval required)

1. Find token addresses: oneinch_tokens(chain="arbitrum", search="USDC") and oneinch_tokens(chain="arbitrum", search="WETH")
2. Check allowance: oneinch_check_allowance(chain="arbitrum", token_address="<USDC_ADDR>")
3. If needs_approval: oneinch_approve(chain="arbitrum", token_address="<USDC_ADDR>")
4. Swap: oneinch_swap(chain="arbitrum", src="<USDC_ADDR>", dst="<WETH_ADDR>", amount="1000000", slippage=1.0)

Price check only (no execution)

Use oneinch_quote to compare prices without executing. This does not require a wallet.

Token Addresses

Token addresses differ between networks. Always use oneinch_tokens(chain="<network>", search="<symbol>") to discover the correct address for a token on a specific chain.

The native gas token address is the same on all EVM chains: 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

Amount Formatting (Wei Conversion)

All amounts must be in wei (the smallest unit of the token):

Always check token decimals with oneinch_tokens before calculating amounts.

Error Handling

Wallet Policy

For 1inch swaps to work, the wallet policy must be active. Use the standard wildcard policy (deny key export + allow *) — see Prerequisites section above.