> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch all known tokens

> Retrieve LI.FI’s catalog of supported tokens, optionally filtered by chain or tag.

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.

<Info>
  Tags and chains can be combined. The response includes only tokens that satisfy all provided filters.
</Info>

## Examples

### Fetch the complete token catalog

```bash theme={"system"}
curl "https://li.quest/v1/tokens"
```

### Fetch all stablecoins

```bash theme={"system"}
curl "https://li.quest/v1/tokens?tags=stablecoin"
```

### Fetch Arbitrum stablecoins

```bash theme={"system"}
curl "https://li.quest/v1/tokens?chains=ARB&tags=stablecoin"
```

<Info>
  More tags may be introduced over time as we add support for more token types.
</Info>


## OpenAPI

````yaml get /v1/tokens
openapi: 3.0.2
info:
  title: LI.FI API
  version: 1.0.0
  description: >-
    LI.FI provides the best cross-chain swap across all liquidity pools and
    bridges.
servers:
  - url: https://li.quest
    description: LI.FI Production Environment
  - url: https://staging.li.quest
    description: LI.FI Staging Environment
security: []
paths:
  /v1/tokens:
    get:
      summary: Fetch all known tokens
      description: >-
        This endpoint can be used to fetch all tokens known to the LI.FI
        services.
      parameters:
        - example: POL,DAI
          name: chains
          description: Restrict the resulting tokens to the given chains
          schema:
            type: string
          in: query
          required: false
        - example: stablecoin
          name: tags
          description: >-
            Restrict the resulting tokens to the given token tags (comma
            separated)
          schema:
            type: string
          in: query
          required: false
        - example: EVM,SVM,UTXO,MVM,TVM
          name: chainTypes
          description: >-
            Restrict the resulting tokens to the given chainTypes. Available
            values: EVM, SVM, UTXO, MVM, TVM.
          schema:
            type: string
          in: query
          required: false
        - example: 0.01
          name: minPriceUSD
          description: >-
            Filters results by minimum token price in USD. Minimum value for
            this parameter is 0. Defaults to 0.0001 USD.
          schema:
            type: number
          in: query
          required: false
        - name: x-lifi-api-key
          description: >-
            Authentication header, register in the LI.FI Partner Portal
            (https://portal.li.fi/ ) to get your API Key.
          schema:
            type: string
          in: header
      responses:
        '200':
          $ref: '#/components/responses/TokensResponse'
components:
  responses:
    TokensResponse:
      content:
        application/json:
          schema:
            type: object
            properties:
              '1':
                description: The requested tokens
                type: array
                items:
                  $ref: '#/components/schemas/Token'
      description: ''
  schemas:
    Token:
      title: Root Type for Token
      description: Representation of a Token
      required:
        - address
        - chainId
        - decimals
        - name
        - symbol
      type: object
      properties:
        address:
          description: Address of the token
          type: string
        decimals:
          format: number
          description: Number of decimals the token uses
          type: number
        symbol:
          description: Symbol of the token
          type: string
        chainId:
          format: number
          description: Id of the token's chain
          type: number
        coinKey:
          description: Identifier for the token
          type: string
        name:
          description: Name of the token
          type: string
        logoURI:
          description: Logo of the token
          type: string
        priceUSD:
          description: Token price in USD
          type: string
      example:
        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

````