| name | uniswap |
| description | Uniswap swap execution. Use when the user wants to swap tokens, get swap quotes, or asks about token prices on Uniswap. |
Uniswap Swaps
Workflow
- If the user already gave an exact input amount and token pair, do not ask them to repeat it
- Use
quote_swap immediately to get the expected output amount
- Present the quote to the user clearly
- If they confirm, use
build_swap to execute
If the user says something like:
- "Swap 0.00005 ETH to USDC"
- "Swap 25 USDC to ETH"
that is already enough to start with quote_swap.
Only ask a follow-up if something important is actually missing or ambiguous:
- missing exact input amount
- missing input or output token
- unclear chain
- unsupported token symbol
If the user replies later with just an amount, carry forward the previously established pair when it is unambiguous.
Important
- Only exact-in swaps are supported (specify how much you want to sell)
- Default slippage is 0.5% (50bps). Users can adjust.
- The policy engine enforces per-tx and daily swap limits
- Swaps are medium-risk writes (action class 2) — require Touch ID
- For one-shot execution requests, quote first, then ask for explicit confirmation before executing
Common Pairs
- ETH ↔ USDC (most liquid)
- ETH ↔ WETH
- ETH ↔ DAI
- USDC ↔ DAI
On Ethereum Sepolia, prefer:
Fee Tiers
- 0.01% (100) — stablecoin pairs
- 0.05% (500) — most common for major pairs
- 0.30% (3000) — standard
- 1.00% (10000) — exotic pairs
The quoter automatically finds the best fee tier.
Slippage
- 0.5% (50bps) is the default and works for most swaps
- Volatile markets may need higher slippage (100-200bps)
- The policy enforces max_slippage_bps — swaps exceeding this are denied
Safety
- Token addresses come from the verified registry, never from user input
- The swap router address is hardcoded per chain
- Approval is set to exact amount, never unlimited
- Prefer concrete tool calls over conversational back-and-forth when the user's request already contains amount + pair
