LI.FI REST API Integration

The LI.FI REST API provides direct HTTP access to cross-chain swap and bridge functionality. Use this API when building backend services, working with non-JavaScript languages, or needing fine-grained control over cross-chain operations.

Base URL

https://li.quest/v1

Authentication

API key is optional but recommended for higher rate limits.

# Without API key (lower rate limits)
curl "https://li.quest/v1/chains"

# With API key (higher rate limits)
curl "https://li.quest/v1/chains" \
  -H "x-lifi-api-key: YOUR_API_KEY"

Important: Never expose your API key in client-side code. Use it only in server-side applications.

Rate Limits

Request an API key from LI.FI for production use with higher limits.

Quick Start

1. Get a Quote

curl "https://li.quest/v1/quote?\
fromChain=42161&\
toChain=10&\
fromToken=0xaf88d065e77c8cC2239327C5EDb3A432268e5831&\
toToken=0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1&\
fromAmount=10000000&\
fromAddress=0xYourAddress&\
slippage=0.005"

2. Execute the Transaction

Use the transactionRequest from the quote response to send the transaction via your wallet or web3 library.

3. Track Status

curl "https://li.quest/v1/status?\
txHash=0xYourTxHash&\
fromChain=42161&\
toChain=10&\
bridge=stargate"

Core Endpoints

GET /quote

Get a single-step quote with transaction data ready for execution.

Parameters:

Example Request:

curl "https://li.quest/v1/quote?\
fromChain=1&\
toChain=137&\
fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&\
toToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&\
fromAmount=1000000000&\
fromAddress=0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0&\
slippage=0.005"

The response includes transactionRequest with all data needed to execute the swap. See references/REFERENCE.md for complete response schema.

POST /advanced/routes

Get multiple route options for comparison. Returns routes without transaction data (use /advanced/stepTransaction to get TX data for a specific step).

Request Body:

{
  "fromChainId": 42161,
  "toChainId": 10,
  "fromTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "toTokenAddress": "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1",
  "fromAmount": "10000000",
  "fromAddress": "0xYourAddress",
  "options": {
    "integrator": "YourAppName",
    "slippage": 0.005,
    "order": "CHEAPEST",
    "bridges": {
      "allow": ["stargate", "hop", "across"]
    },
    "exchanges": {
      "allow": ["1inch", "uniswap"]
    },
    "allowSwitchChain": true,
    "maxPriceImpact": 0.1
  }
}

Example Request:

curl -X POST "https://li.quest/v1/advanced/routes" \
  -H "Content-Type: application/json" \
  -d '{
    "fromChainId": 42161,
    "toChainId": 10,
    "fromTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "toTokenAddress": "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1",
    "fromAmount": "10000000",
    "options": {
      "slippage": 0.005,
      "integrator": "YourApp"
    }
  }'

Returns array of routes sorted by order preference. Each route contains steps but no transactionRequest - use /advanced/stepTransaction to get TX data.

POST /advanced/stepTransaction

Populate a step (from /advanced/routes) with transaction data. Use this after selecting a route to get the actual transaction to execute.

Request Body: Send the full Step object from a route.

Query Parameters:

Example:

curl -X POST "https://li.quest/v1/advanced/stepTransaction" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "step-id",
    "type": "cross",
    "tool": "stargate",
    "action": {...},
    "estimate": {...}
  }'

Response: Returns the Step object with transactionRequest populated.

GET /status

Track transaction status across chains. Can query by sending TX hash, receiving TX hash, or transactionId.

Parameters:

For same-chain swaps, set fromChain and toChain to the same value.

Example Request:

curl "https://li.quest/v1/status?txHash=0x123abc..."

Response includes: transactionId, sending (txHash, amount, chainId), receiving (txHash, amount, chainId), status, substatus, lifiExplorerLink.

Status Values: NOT_FOUND, INVALID, PENDING, DONE, FAILED

Poll until status is DONE or FAILED. See references/REFERENCE.md for complete substatus values.

GET /chains

Get all supported chains.

Parameters:

curl "https://li.quest/v1/chains"
curl "https://li.quest/v1/chains?chainTypes=EVM,SVM"

GET /tokens

Get tokens for specified chains.

Parameters:

curl "https://li.quest/v1/tokens?chains=1,137,42161"

GET /token

Get information about a specific token.

Parameters:

curl "https://li.quest/v1/token?chain=POL&token=DAI"

GET /tools

Get available bridges and exchanges. Use this to discover valid tool keys for filtering quotes.

Parameters:

curl "https://li.quest/v1/tools"
curl "https://li.quest/v1/tools?chains=1,137"

Returns bridges and exchanges arrays with key, name, and supportedChains. Use these keys in allowBridges, denyBridges, allowExchanges, etc.

Special values: all, none, default, []

GET /connections

Get available token pair connections. At least one filter (chain, token, bridge, or exchange) is required.

Parameters:

curl "https://li.quest/v1/connections?\
fromChain=POL&\
fromToken=DAI"

POST /quote/contractCalls

Get a quote for bridging tokens and performing multiple contract calls on the destination chain. This enables 1-click DeFi workflows like bridge + swap + deposit.

Request Body:

{
  "fromChain": 10,
  "fromToken": "0x4200000000000000000000000000000000000042",
  "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
  "toChain": 1,
  "toToken": "ETH",
  "toAmount": "100000000000001",
  "integrator": "YourAppName",
  "contractCalls": [
    {
      "fromAmount": "100000000000001",
      "fromTokenAddress": "0x0000000000000000000000000000000000000000",
      "toTokenAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
      "toContractAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
      "toContractCallData": "0x",
      "toContractGasLimit": "110000"
    },
    {
      "fromAmount": "100000000000000",
      "fromTokenAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
      "toTokenAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
      "toContractAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
      "toFallbackAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
      "toContractCallData": "0xea598cb000000000000000000000000000000000000000000000000000005af3107a4000",
      "toContractGasLimit": "100000"
    }
  ]
}

Integration Examples

Python

import requests

BASE_URL = "https://li.quest/v1"

def get_quote(from_chain, to_chain, from_token, to_token, amount, address):
    response = requests.get(f"{BASE_URL}/quote", params={
        "fromChain": from_chain,
        "toChain": to_chain,
        "fromToken": from_token,
        "toToken": to_token,
        "fromAmount": amount,
        "fromAddress": address,
        "slippage": 0.005
    })
    return response.json()

def get_status(tx_hash, from_chain, to_chain, bridge):
    response = requests.get(f"{BASE_URL}/status", params={
        "txHash": tx_hash,
        "fromChain": from_chain,
        "toChain": to_chain,
        "bridge": bridge
    })
    return response.json()

# Example usage
quote = get_quote(
    from_chain=42161,
    to_chain=10,
    from_token="0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    to_token="0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1",
    amount="10000000",
    address="0xYourAddress"
)

print(f"Estimated output: {quote['estimate']['toAmount']}")
print(f"Gas cost: {quote['estimate']['gasCosts']}")

Node.js (fetch)

const BASE_URL = 'https://li.quest/v1';

async function getQuote(params) {
  const searchParams = new URLSearchParams(params);
  const response = await fetch(`${BASE_URL}/quote?${searchParams}`);
  return response.json();
}

async function getRoutes(body) {
  const response = await fetch(`${BASE_URL}/routes`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });
  return response.json();
}

async function pollStatus(txHash, fromChain, toChain, bridge) {
  const params = new URLSearchParams({ txHash, fromChain, toChain, bridge });
  
  while (true) {
    const response = await fetch(`${BASE_URL}/status?${params}`);
    const data = await response.json();
    
    if (data.status === 'DONE' || data.status === 'FAILED') {
      return data;
    }
    
    await new Promise(resolve => setTimeout(resolve, 5000));
  }
}

// Example usage
const quote = await getQuote({
  fromChain: 42161,
  toChain: 10,
  fromToken: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
  toToken: '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1',
  fromAmount: '10000000',
  fromAddress: '0xYourAddress',
  slippage: 0.005,
});

Error Handling

See references/REFERENCE.md for complete error codes and response schemas.

Best Practices

1. Always specify slippage - Default is conservative. Adjust based on token volatility.

2. Poll status endpoint - For cross-chain transfers, poll every 5-10 seconds until DONE or FAILED.

3. Handle rate limits - Implement exponential backoff for 429 responses.

4. Cache chain/token data - /chains and /tokens responses change infrequently.

5. Use integrator parameter - Always include integrator for analytics and potential monetization.

6. Validate addresses - Ensure token addresses match the specified chain.

7. Handle gas estimation - The API provides gas estimates, but actual costs may vary.

See references/REFERENCE.md for complete endpoint documentation and response schemas.