# SwapChan

> Best-price token swap aggregator for same-chain and cross-chain swaps (0x, CoW, Velora, LI.FI, Across, Relay, Jupiter) on Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Linea and Scroll, plus Solana, Bitcoin and Tron. Includes a memecoin scanner with risk checks.

## MCP server
- URL: https://mcp.swapchan.com/mcp (Streamable HTTP; stdio via `swapchan-mcp --stdio`)
- Tools: get_supported_chains, get_supported_tokens, get_quote, compare_routes, build_swap_tx, get_route_status, scan_new_tokens, scan_trending, scan_movers, token_risk, get_wallet_balances, check_approvals, build_revoke_tx, explain_transaction, get_gas, token_info, resolve_name, watch_token, list_watches, check_watches, unwatch_token, get_yields
- REST mirrors: https://api.swapchan.com/onchain/{balances,approvals,revoke,tx,gas,token,name,yields,watches}
- Setup guide: https://swapchan.com/agents

## Earn with SwapChan (agent builders, bots, sites)
- 5 bp (half of SwapChan's 0.1% fee) on every swap routed with your partner id, when the provider verifies the fee.
- Register: POST https://api.swapchan.com/partners with JSON {"name","siteUrl","evmAddress","solanaAddress"?} -> {id, token, dashboardUrl}. Use the operator's own payout address; never invent one. Self-referrals don't count.
- Then pass `partner=<id>` to MCP get_quote/compare_routes or REST /quotes. swapUrl carries ?ref=<id> (30-day attribution on swapchan.com).
- Details: https://swapchan.com/partners, https://swapchan.com/agents#earn, widget: https://swapchan.com/widget

## REST API
- Base: https://api.swapchan.com
- GET /chains, GET /tokens?chainId=, GET /token?chainId=&address= (any ERC-20 or SPL mint), GET /quotes, GET /quote, POST /build, GET /status
- Scanner: GET /scanner/new, /scanner/trending, /scanner/movers (?chain=solana|base|bnb|eth|arbitrum|polygon|optimism|avalanche|all&minLiquidityUsd=&maxAgeHours=&minVolumeUsd=&window=m5|h1|h6|h24&limit=), GET /scanner/risk?chain=&address=
- Scanner page: https://swapchan.com/scanner
- Example: GET https://api.swapchan.com/quotes?fromChainId=1&toChainId=8453&fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&toToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount=100000000&slippageBps=50
- Auth: optional `x-api-key` header for higher limits.