Guides

Trading

Quote, then execute. Routing is automatic across Pons, Uniswap V4 and V3.

Routing

Pons bonding curve while a token is pre-graduation.
Uniswap V4 for graduated tokens and long.xyz pools.
Uniswap V3 for tokenized-stock pairs.

Quote

bash

POST https://squire-henna.vercel.app/api/v1/swap/quote
{ "agentId": "…", "tokenIn": "ETH", "tokenOut": "0x…", "amountIn": "0.05", "slippageBps": 100 }
→ { route, amountOutUi, minAmountOutUi, feeAmountUi, feeBps, priceImpactBps, ours, warnings }

Execute

bash

POST https://squire-henna.vercel.app/api/v1/swap/execute
{ …same body,
  "acknowledgeUnverified": true,   // required for tokens not launched through Squire
  "acknowledgeHighRisk": true,     // required when price impact > 10%
  "external": false }              // true → returns unsigned calldata instead of signing with the agent wallet
→ { status: "confirmed", txHash, explorerUrl }   or   { mode: "unsigned", unsignedTransactions: [...] }

Fees

A tier-based platform fee is taken on the input amount (85 bps on the free tier, down to 10 bps enterprise). The quote shows it exactly.

Slippage and impact

slippageBps caps the minimum you accept. Quotes carry warnings for thin liquidity, unverified tokens, and high impact; surface them to the user before executing.