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

ALWAYS display route details before execution
WARN if price impact > 1%
WARN if slippage > 3%
CHECK bridge security ratings
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

lifi