0x-swap

0x Swap API 🔷

Professional-grade DEX aggregation. Best execution across 9+ liquidity sources with MEV protection.

Environment Variables

Variable	Description	Required
ZEROX_API_KEY	0x API Key (get free at 0x.org)	Yes

💎 Swap Fee Configuration

This skill includes a small swap fee (0.3%) to support development. The fee is transparently disclosed to users before each swap.

Variable	Value	Description
SWAP_FEE_BPS	30	0.3% swap fee (30 basis points)
SWAP_FEE_RECIPIENT	0x890CACd9dEC1E1409C6598Da18DC3d634e600b45	EVM wallet to receive fees
SWAP_FEE_TOKEN	outputToken	Collect fee in output token

Fee Breakdown:

• User pays: 0.3% of swap output
• Developer receives: 100% of fee
• Fees are collected on-chain directly to your wallet

Features

• 🔄 DEX Aggregation - Best rates across Uniswap, SushiSwap, Curve, etc.
• 🛡️ MEV Protection - Gasless swaps with MEV protection
• ⛓️ Multi-Chain - Ethereum, Polygon, BSC, Arbitrum, Optimism, Base
• 📊 Real-time Analytics - Trade insights and execution quality
• 💰 Native Monetization - Built-in swap fee support

API Base URLs

Chain	URL
Ethereum	https://api.0x.org
Polygon	https://polygon.api.0x.org
BSC	https://bsc.api.0x.org
Arbitrum	https://arbitrum.api.0x.org
Optimism	https://optimism.api.0x.org
Base	https://base.api.0x.org

Get Swap Quote

API_KEY="${ZEROX_API_KEY}"
CHAIN_ID="1"  # Ethereum

# Token addresses
SELL_TOKEN="0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"  # WETH
BUY_TOKEN="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"   # USDC
SELL_AMOUNT="1000000000000000000"  # 1 ETH in wei
TAKER="<YOUR_WALLET>"

# Swap fee configuration
SWAP_FEE_BPS="30"  # 0.3%
SWAP_FEE_RECIPIENT="0x890CACd9dEC1E1409C6598Da18DC3d634e600b45"
SWAP_FEE_TOKEN="${BUY_TOKEN}"  # Collect fee in output token

curl -s "https://api.0x.org/swap/permit2/quote" \
  -H "0x-api-key: ${API_KEY}" \
  -H "0x-version: v2" \
  -G \
  --data-urlencode "chainId=${CHAIN_ID}" \
  --data-urlencode "sellToken=${SELL_TOKEN}" \
  --data-urlencode "buyToken=${BUY_TOKEN}" \
  --data-urlencode "sellAmount=${SELL_AMOUNT}" \
  --data-urlencode "taker=${TAKER}" \
  --data-urlencode "swapFeeBps=${SWAP_FEE_BPS}" \
  --data-urlencode "swapFeeRecipient=${SWAP_FEE_RECIPIENT}" \
  --data-urlencode "swapFeeToken=${SWAP_FEE_TOKEN}" | jq '{
    buyAmount: .buyAmount,
    sellAmount: .sellAmount,
    price: .price,
    estimatedGas: .gas,
    route: .route,
    swapFee: {
      bps: .swapFeeBps,
      recipient: .swapFeeRecipient,
      amount: .swapFeeAmount
    }
  }'