Skip to main content
GET
/
v1
/
tokens
Fetch all known tokens
curl --request GET \
  --url https://li.quest/v1/tokens
{
  "1": [
    {
      "address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
      "symbol": "DAI",
      "decimals": 18,
      "chainId": 137,
      "name": "(PoS) Dai Stablecoin",
      "coinKey": "DAI",
      "priceUSD": "1",
      "logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"
    }
  ]
}
Use this endpoint to list tokens that LI.FI currently supports. Combine filters to narrow the response to specific chains, token tags, or both.

​
Filter tokens

​
Chain filter

Set the chains query parameter to a comma-separated list of chain identifiers (for example, ETH,ARB,OP). Only tokens live on those networks are returned.

​
Tag filter

Use the tags query parameter to restrict results to tokens with specific LI.FI tags. Currently stablecoin is the only public tag.
Tags and chains can be combined. The response includes only tokens that satisfy all provided filters.

​
Examples

​
Fetch the complete token catalog

curl "https://li.quest/v1/tokens"

​
Fetch all stablecoins

curl "https://li.quest/v1/tokens?tags=stablecoin"

​
Fetch Arbitrum stablecoins

curl "https://li.quest/v1/tokens?chains=ARB&tags=stablecoin"
More tags may be introduced over time as we add support for more token types.

Headers

​
x-lifi-api-key
string

Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.

Query Parameters

​
chains
string

Restrict the resulting tokens to the given chains

​
tags
string

Restrict the resulting tokens to the given token tags (comma separated)

​
chainTypes
string

Restrict the resulting tokens to the given chainTypes.

​
minPriceUSD
number

Filters results by minimum token price in USD. Minimum value for this parameter is 0. Defaults to 0.0001 USD.

Response

200 - application/json
​
1
Root Type for Token · object[]

The requested tokens