---
agentTools:
  projectIndex: https://imx.readme.io/llms.txt
---

# Get a list of tokens

Get a list of tokens

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Immutable X API",
    "version": "1.0",
    "description": "https://docs.x.immutable.com/reference",
    "contact": {
      "name": "Immutable",
      "url": "https://godsunchained.com"
    }
  },
  "servers": [
    {
      "url": "https://api.x.immutable.com",
      "description": "Production Environment"
    },
    {
      "url": "https://api.ropsten.x.immutable.com",
      "description": "Ropsten Environment"
    }
  ],
  "paths": {
    "/v1/tokens": {
      "get": {
        "summary": "Get a list of tokens",
        "tags": [
          "tokens"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenList"
                }
              }
            }
          }
        },
        "operationId": "getTokens",
        "description": "Get a list of tokens",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "address",
            "description": "Contract address of the token"
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "symbols",
            "description": "Token symbols for the token, e.g. ?symbols=IMX,ETH"
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Token": {
        "description": "",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "image_url": {
            "type": "string",
            "minLength": 1
          },
          "token_address": {
            "type": "string"
          },
          "symbol": {
            "type": "string",
            "minLength": 1
          },
          "decimals": {
            "type": "string",
            "minLength": 1
          },
          "quantum": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "name",
          "image_url",
          "token_address",
          "symbol",
          "decimals",
          "quantum"
        ],
        "x-examples": {
          "example-1": {
            "name": "Ethereum",
            "image_url": "https://design-system.immutable.com/currency_icons/currency--eth.svg",
            "token_address": "",
            "symbol": "ETH",
            "decimals": "18",
            "quantum": "100000000"
          }
        }
      },
      "TokenList": {
        "title": "TokenList",
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string"
          },
          "result": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Token"
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "tokens"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 97,
      "1": 222,
      "2": 73,
      "3": 4,
      "4": 47,
      "5": 148,
      "6": 195,
      "7": 0,
      "8": 100,
      "9": 250,
      "10": 119,
      "11": 107
    }
  }
}
```