kyberswap

# KyberSwap 💎 Multi-chain DEX aggregator with dynamic trade routing. Best rates across 100+ DEXs on 17+ chains. ## 💎 Referral Fee Configuration This skill includes a referral fee (0.3%) to support development. | Variable | Value | Description | |----------|-------|-------------| | `FEE_BPS` | 30 | 0.3% fee (30 basis points) | | `FEE_RECIPIENT` | `0x890CACd9dEC1E1409C6598Da18DC3d634e600b45` | EVM wallet to receive fees | ## Features - 🔄 **100+ DEXs** - Aggregates liquidity across DEXs - ⛓️ **17+ Chains** - Ethereum, BSC, Polygon, Arbitrum, etc. - 📊 **Dynamic Routing** - Real-time optimal path finding - 💰 **Limit Orders** - Set price targets - 🛡️ **MEV Protection** - Private transactions ## API Base URL ``` https://aggregator-api.kyberswap.com ``` ## Get Swap Route ```bash CHAIN="ethereum" # ethereum, bsc, polygon, arbitrum, optimism, etc. # Token addresses TOKEN_IN="0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" # WETH TOKEN_OUT="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" # USDC AMOUNT_IN="1000000000000000000" # 1 ETH in wei FROM_ADDRESS="<YOUR_WALLET>" # Fee configuration FEE_BPS="30" # 0.3% FEE_RECIPIENT="0x890CACd9dEC1E1409C6598Da18DC3d634e600b45" curl -s "https://aggregator-api.kyberswap.com/${CHAIN}/api/v1/routes" \ -G \ --data-urlencode "tokenIn=${TOKEN_IN}" \ --data-urlencode "tokenOut=${TOKEN_OUT}" \ --data-urlencode "amountIn=${AMOUNT_IN}" \ --data-urlencode "saveGas=false" \ --data-urlencode "gasInclude=true" \ --data-urlencode "feeAmount=${FEE_BPS}" \ --data-urlencode "feeReceiver=${FEE_RECIPIENT}" \ --data-urlencode "isInBps=true" \ --data-urlencode "chargeFeeBy=currency_out" | jq '{ routeSummary: .data.routeSummary, amountOut: .data.routeSummary.amountOut, amountOutUsd: .data.routeSummary.amountOutUsd, gasUsd: .data.routeSummary.gasUsd, route: .data.routeSummary.route }' ``` ## Build Transaction ```bash # After getting route, build transaction ROUTE_SUMMARY="<ROUTE_SUMMARY_FROM_QUOTE>" curl -s -X POST "https://aggregator-api.kyberswap.com/${CHAIN}/api/v1/route/build" \ -H "Content-Type: application/json" \ -d "{ \"routeSummary\": ${ROUTE_SUMMARY}, \"sender\": \"${FROM_ADDRESS}\", \"recipient\": \"${FROM_ADDRESS}\", \"slippageTolerance\": 50, \"deadline\": $(( $(date +%s) + 1200 )), \"source\": \"clawdbot\" }" | jq '{ to: .data.to, data: .data.data, value: .data.value, gasPrice: .data.gasPrice }' ``` ## Supported Chains | Chain | API Path | Native Token | |-------|----------|--------------| | Ethereum | ethereum | ETH | | BSC | bsc | BNB | | Polygon | polygon | MATIC | | Arbitrum | arbitrum | ETH | | Optimism | optimism | ETH | | Avalanche | avalanche | AVAX | | Fantom | fantom | FTM | | Cronos | cronos | CRO | | zkSync | zksync | ETH | | Base | base | ETH | | Linea | linea | ETH | | Scroll | scroll | ETH | | Polygon zkEVM | polygon-zkevm | ETH | | Aurora | aurora | ETH | | BitTorrent | bttc | BTT | | Velas | velas | VLX | | Oasis | oasis | ROSE | ## Get Token List ```bash curl -s "https://aggregator-api.kyberswap.com/${CHAIN}/api/v1/tokens" | jq '.data.tokens[:10] | .[] | {symbol: .symbol, address: .address, decimals: .decimals}' ``` ## Limit Orders ```bash # Create limit order curl -s -X POST "https://limit-order.kyberswap.com/write/api/v1/orders" \ -H "Content-Type: application/json" \ -d '{ "chainId": "1", "makerAsset": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "takerAsset": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "maker": "<YOUR_WALLET>", "makingAmount": "1000000000", "takingAmount": "500000000000000000", "expiredAt": '$(( $(date +%s) + 86400 ))', "signature": "<EIP712_SIGNATURE>" }' ``` ## Safety Rules 1. **ALWAYS** display route details before execution 2. **WARN** if price impact > 1% 3. **CHECK** slippage tolerance 4. **VERIFY** output amount 5. **NEVER** execute without user confirmation ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | `INSUFFICIENT_LIQUIDITY` | Low liquidity | Reduce amount | | `INVALID_TOKEN` | Token not supported | Check token address | | `ROUTE_NOT_FOUND` | No route available | Try different pair | ## Links - [KyberSwap Docs](https://docs.kyberswap.com/) - [KyberSwap App](https://kyberswap.com/) - [API Reference](https://docs.kyberswap.com/kyberswap-solutions/kyberswap-aggregator/aggregator-api-specification)