---
title: "Get token list for a chain"
method: GET
path: "/list/{chain_id}"
tags: ["Token Lists"]
---

# Get token list for a chain

`GET /list/{chain_id}`

Retrieve the complete token list for a specific blockchain network

## Path parameters

- `chain_id` 4217 | 42431 | 31318, required

## Response `200`

Successful response with token list

- TokenList — Token list for a specific blockchain network
  - `schema` string, url — JSON Schema reference
  - `name` string, required — Name of the token list
  - `timestamp` string, date-time — Timestamp of this list version
  - `version` Version — Version information for the token list
    - `major` integer, required — Major version (incremented when tokens are removed or addresses changed)
    - `minor` integer, required — Minor version (incremented when tokens are added)
    - `patch` integer, required — Patch version (incremented for any changes)
  - `logo_uri` string, url — URI for the logo of the token list
  - `keywords` string[], required — Keywords associated with the token list
  - `tags` TagsMap — Mapping of tag identifiers to their definitions
  - `tokens` TokenInfo[], required — List of tokens included in the list
    - `chain_id` integer, required — Chain ID of the network where token is deployed
    - `address` string, required — Checksummed address of the token contract
    - `decimals` integer, required — Number of decimals for token balance
    - `name` string, required — Name of the token
    - `symbol` string, required — Symbol of the token
    - `logo_uri` string, url — URI to the token logo (SVG or PNG, 64x64 recommended)
    - `tags` string[], required — Array of tag identifiers associated with the token
    - `extensions` ExtensionMap — Object containing arbitrary or vendor-specific token metadata
  - `token_map` TokenMap — Mapping of 'chainId_tokenAddress' to token objects

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.dev/tempoxyz/apis/tokenlist-api.md) · [All operations](https://skmtc.dev/tempoxyz/apis/tokenlist-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tempoxyz/tokenlist-api/revisions/0ec4992549cb/schema)