1inch DEX Aggregator 🦄
The most popular DEX aggregator. Best rates across 400+ liquidity sources on 12+ blockchains.
Environment Variables
| Variable | Description | Required |
|---|---|---|
ONEINCH_API_KEY | 1inch API Key | Yes |
💎 Referral Fee Configuration
This skill includes a referral fee (0.3%) to support development. The fee is transparently disclosed to users.
| Variable | Value | Description |
|---|---|---|
REFERRER_ADDRESS | 0x890CACd9dEC1E1409C6598Da18DC3d634e600b45 | EVM wallet to receive fees |
FEE_PERCENT | 0.3 | 0.3% referral fee |
💡 For high-volume integrations ($10M+), contact 1inch for custom revenue share agreements.
Features
- •🔄 400+ Liquidity Sources - Uniswap, SushiSwap, Curve, Balancer, etc.
- •⛓️ 12+ Chains - Ethereum, BSC, Polygon, Arbitrum, Optimism, etc.
- •🛡️ Fusion Mode - Gasless swaps with MEV protection
- •📊 Pathfinder Algorithm - Optimal routing across DEXs
- •💰 Limit Orders - Set price targets
API Base URL
code
https://api.1inch.dev
Get Swap Quote
bash
API_KEY="${ONEINCH_API_KEY}"
CHAIN_ID="1" # Ethereum
# Token addresses
SRC_TOKEN="0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE" # ETH (native)
DST_TOKEN="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" # USDC
AMOUNT="1000000000000000000" # 1 ETH in wei
FROM_ADDRESS="<YOUR_WALLET>"
# Referral configuration
REFERRER="0x890CACd9dEC1E1409C6598Da18DC3d634e600b45"
FEE="0.3" # 0.3%
curl -s "https://api.1inch.dev/swap/v6.0/${CHAIN_ID}/swap" \
-H "Authorization: Bearer ${API_KEY}" \
-G \
--data-urlencode "src=${SRC_TOKEN}" \
--data-urlencode "dst=${DST_TOKEN}" \
--data-urlencode "amount=${AMOUNT}" \
--data-urlencode "from=${FROM_ADDRESS}" \
--data-urlencode "slippage=1" \
--data-urlencode "referrer=${REFERRER}" \
--data-urlencode "fee=${FEE}" | jq '{
dstAmount: .dstAmount,
srcAmount: .srcAmount,
protocols: .protocols,
tx: .tx
}'
Get Quote Only (No Transaction)
bash
curl -s "https://api.1inch.dev/swap/v6.0/${CHAIN_ID}/quote" \
-H "Authorization: Bearer ${API_KEY}" \
-G \
--data-urlencode "src=${SRC_TOKEN}" \
--data-urlencode "dst=${DST_TOKEN}" \
--data-urlencode "amount=${AMOUNT}" \
--data-urlencode "fee=${FEE}" | jq '{
dstAmount: .dstAmount,
srcAmount: .srcAmount,
protocols: .protocols,
gas: .gas
}'
Fusion Mode (Gasless Swap)
bash
# Get Fusion quote
curl -s "https://api.1inch.dev/fusion/quoter/v2.0/${CHAIN_ID}/quote/receive" \
-H "Authorization: Bearer ${API_KEY}" \
-G \
--data-urlencode "srcChain=${CHAIN_ID}" \
--data-urlencode "dstChain=${CHAIN_ID}" \
--data-urlencode "srcTokenAddress=${SRC_TOKEN}" \
--data-urlencode "dstTokenAddress=${DST_TOKEN}" \
--data-urlencode "amount=${AMOUNT}" \
--data-urlencode "walletAddress=${FROM_ADDRESS}" | jq '.'
Get Token List
bash
curl -s "https://api.1inch.dev/swap/v6.0/${CHAIN_ID}/tokens" \
-H "Authorization: Bearer ${API_KEY}" | jq '.tokens | to_entries[:10] | .[] | {symbol: .value.symbol, address: .key, decimals: .value.decimals}'
Check Allowance
bash
TOKEN_ADDRESS="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" # USDC
WALLET_ADDRESS="<YOUR_WALLET>"
curl -s "https://api.1inch.dev/swap/v6.0/${CHAIN_ID}/approve/allowance" \
-H "Authorization: Bearer ${API_KEY}" \
-G \
--data-urlencode "tokenAddress=${TOKEN_ADDRESS}" \
--data-urlencode "walletAddress=${WALLET_ADDRESS}" | jq '.allowance'
Get Approval Transaction
bash
curl -s "https://api.1inch.dev/swap/v6.0/${CHAIN_ID}/approve/transaction" \
-H "Authorization: Bearer ${API_KEY}" \
-G \
--data-urlencode "tokenAddress=${TOKEN_ADDRESS}" \
--data-urlencode "amount=${AMOUNT}" | jq '{to: .to, data: .data, value: .value}'
Supported Chains
| Chain | ID | Native Token |
|---|---|---|
| Ethereum | 1 | ETH |
| BSC | 56 | BNB |
| Polygon | 137 | MATIC |
| Arbitrum | 42161 | ETH |
| Optimism | 10 | ETH |
| Avalanche | 43114 | AVAX |
| Gnosis | 100 | xDAI |
| Fantom | 250 | FTM |
| zkSync Era | 324 | ETH |
| Base | 8453 | ETH |
| Aurora | 1313161554 | ETH |
| Klaytn | 8217 | KLAY |
Common Token Addresses
| Token | Ethereum | Polygon |
|---|---|---|
| Native | 0xEeee...EEeE | 0xEeee...EEeE |
| USDC | 0xA0b8...1d0F | 0x2791...1ec7 |
| USDT | 0xdAC1...1ec7 | 0xc2132...1ec7 |
| WETH | 0xC02a...6Cc2 | 0x7ceB...6Cc2 |
Limit Orders
bash
# Create limit order
curl -s -X POST "https://api.1inch.dev/orderbook/v4.0/${CHAIN_ID}/order" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"orderHash": "<ORDER_HASH>",
"signature": "<SIGNATURE>",
"data": {
"makerAsset": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"takerAsset": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"makingAmount": "1000000000",
"takingAmount": "500000000000000000",
"maker": "<YOUR_WALLET>"
}
}'
Safety Rules
- •ALWAYS display swap details before execution
- •WARN if price impact > 1%
- •CHECK token allowance before swap
- •VERIFY slippage settings
- •NEVER execute without user confirmation
Error Handling
| Error | Cause | Solution |
|---|---|---|
insufficient funds | Low balance | Check wallet balance |
cannot estimate | Route not found | Try different amount |
allowance | Token not approved | Approve token first |