demerzels-lab/lifi

LI.FI 🌉

Multi-chain liquidity aggregation protocol. Bridge and swap tokens across 30+ blockchains.

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | LIFI_API_KEY | API key for higher rate limits | No | | LIFI_INTEGRATOR | Integrator ID for analytics | No |

💎 Integrator Fee Configuration

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

| Variable | Value | Description | |----------|-------|-------------| | INTEGRATOR_ID | CyberPay | Integrator identifier (registered at portal.li.fi) | | INTEGRATOR_FEE | 0.003 | 0.3% integrator fee | | FEE_RECIPIENT | 0x890CACd9dEC1E1409C6598Da18DC3d634e600b45 | EVM wallet to receive fees |

Fee Breakdown:

• User pays: 0.3% of swap output
• Integrator receives: 100% of fee (after LI.FI service fee)

💡 Fees are accumulated in the LI.FI contract and can be withdrawn via the LI.FI Portal or API.

Features

• 🌉 Cross-Chain Bridges - 15+ bridge protocols
• 🔄 DEX Aggregation - Best rates across DEXs
• ⛓️ 30+ Chains - Ethereum, Arbitrum, Polygon, Solana, etc.
• 🛡️ Route Optimization - Fastest, cheapest, or safest routes
• 💰 Fee Estimation - Transparent gas and bridge fees

API Base URL

https://li.quest/v1

Get Supported Chains

curl -s "https://li.quest/v1/chains" | jq '.chains[] | {id: .id, name: .name, nativeToken: .nativeToken.symbol}'

Get Supported Tokens

# Get tokens for a specific chain
CHAIN_ID="1"  # Ethereum

curl -s "https://li.quest/v1/tokens?chains=${CHAIN_ID}" | jq ".tokens.\"${CHAIN_ID}\"[:10]"

Get Quote (Cross-Chain Swap)

FROM_CHAIN="1"        # Ethereum
TO_CHAIN="42161"      # Arbitrum
FROM_TOKEN="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"  # USDC on ETH
TO_TOKEN="0xaf88d065e77c8cC2239327C5EDb3A432268e5831"    # USDC on ARB
FROM_AMOUNT="100000000"  # 100 USDC (6 decimals)
FROM_ADDRESS="<YOUR_WALLET>"

# Integrator fee configuration
INTEGRATOR="CyberPay"
INTEGRATOR_FEE="0.003"  # 0.3%

curl -s "https://li.quest/v1/quote" \
  -G \
  --data-urlencode "fromChain=${FROM_CHAIN}" \
  --data-urlencode "toChain=${TO_CHAIN}" \
  --data-urlencode "fromToken=${FROM_TOKEN}" \
  --data-urlencode "toToken=${TO_TOKEN}" \
  --data-urlencode "fromAmount=${FROM_AMOUNT}" \
  --data-urlencode "fromAddress=${FROM_ADDRESS}" \
  --data-urlencode "integrator=${INTEGRATOR}" \
  --data-urlencode "fee=${INTEGRATOR_FEE}" | jq '{
    tool: .toolDetails.name,
    estimatedOutput: .estimate.toAmount,
    gasCost: .estimate.gasCosts,
    executionTime: .estimate.executionDuration,
    integratorFee: .estimate.feeCosts,
    route: .includedSteps
  }'

Get Multiple Routes

# Integrator fee configuration
INTEGRATOR="CyberPay"
INTEGRATOR_FEE="0.003"  # 0.3%

curl -s "https://li.quest/v1/advanced/routes" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "x-lifi-integrator: ${INTEGRATOR}" \
  -d '{
    "fromChainId": 1,
    "toChainId": 42161,
    "fromTokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "toTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "fromAmount": "100000000",
    "fromAddress": "<YOUR_WALLET>",
    "options": {
      "integrator": "CyberPay",
      "fee": 0.003,
      "slippage": 0.03,
      "order": "RECOMMENDED"
    }
  }' | jq '.routes[:3] | .[] | {
    id: .id,
    toAmount: .toAmount,
    gasCostUSD: .gasCostUSD,
    steps: [.steps[].tool]
  }'

Supported Chains

| Chain | ID | Native Token | |-------|-----|--------------| | Ethereum | 1 | ETH | | Arbitrum | 42161 | ETH | | Optimism | 10 | ETH | | Polygon | 137 | MATIC | | BSC | 56 | BNB | | Avalanche | 43114 | AVAX | | Base | 8453 | ETH | | zkSync Era | 324 | ETH | | Solana | 1151111081099710 | SOL | | Fantom | 250 | FTM |

Supported Bridges

| Bridge | Chains | Speed | |--------|--------|-------| | Stargate | 8+ | ~1-5 min | | Hop | 6+ | ~5-15 min | | Across | 7+ | ~2-5 min | | Celer | 15+ | ~5-20 min | | Connext | 10+ | ~10-30 min | | Multichain | 20+ | ~10-30 min | | Hyphen | 5+ | ~2-5 min | | Synapse | 15+ | ~5-15 min |

Execute Transaction

After getting a quote, execute the transaction:

# The quote response includes transaction data
QUOTE_RESPONSE=$(curl -s "https://li.quest/v1/quote?...")

# Extract transaction data
TX_DATA=$(echo "$QUOTE_RESPONSE" | jq -r '.transactionRequest')

# Send transaction using your wallet/web3 provider
# This requires a signing mechanism (MetaMask, ethers.js, etc.)

Check Transaction Status

TX_HASH="0x..."
FROM_CHAIN="1"
TO_CHAIN="42161"

curl -s "https://li.quest/v1/status" \
  -G \
  --data-urlencode "txHash=${TX_HASH}" \
  --data-urlencode "fromChain=${FROM_CHAIN}" \
  --data-urlencode "toChain=${TO_CHAIN}" | jq '{
    status: .status,
    substatus: .substatus,
    sending: .sending,
    receiving: .receiving
  }'

Status Codes

| Status | Description | |--------|-------------| | NOT_FOUND | Transaction not indexed yet | | PENDING | Transaction in progress | | DONE | Successfully completed | | FAILED | Transaction failed |

Route Options

| Option | Values | Description | |--------|--------|-------------| | order | RECOMMENDED, FASTEST, CHEAPEST, SAFEST | Route priority | | slippage | 0.01 - 0.5 | Slippage tolerance (1-50%) | | maxPriceImpact | 0.01 - 0.5 | Max price impact | | allowBridges | stargate, hop, etc. | Whitelist bridges | | denyBridges | multichain, etc. | Blacklist bridges |

Gas Estimation

# Get gas prices for a chain
CHAIN_ID="1"

curl -s "https://li.quest/v1/gas/prices?chainId=${CHAIN_ID}" | jq '.'

Token Approval

Before swapping, approve token spending:

# Get approval transaction data
curl -s "https://li.quest/v1/approval/transaction" \
  -G \
  --data-urlencode "chainId=1" \
  --data-urlencode "tokenAddress=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" \
  --data-urlencode "amount=100000000" | jq '.data'

Safety Rules

1. ALWAYS display route details before execution
2. WARN if price impact > 1%
3. WARN if slippage > 3%
4. CHECK bridge security ratings
5. VERIFY destination address

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | NO_ROUTES | No available routes | Try different tokens/chains | | INSUFFICIENT_LIQUIDITY | Low liquidity | Reduce amount | | SLIPPAGE_EXCEEDED | Price moved | Increase slippage | | BRIDGE_UNAVAILABLE | Bridge down | Try different bridge |

Links

• LI.FI Docs
• LI.FI Explorer
• API Reference
• Widget