# Uniswap/token-lists

📚 The Token Lists specification

Repository: https://github.com/Uniswap/token-lists
Canonical: https://ross.abutalabs.com/products/token-lists
Homepage: https://tokenlists.org
Language: TypeScript
License: MIT
License Family: permissive
Topics: uniswap, tokens, erc20
Last push: 2026-03-10T19:41:15+00:00

## Health v2 (maintenance only)
Score: 55/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 71, release rhythm 8, longevity 100
- inputs: {"age_days": 2275, "days_push": 176, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1724, forks 1236 (observed 2026-08-28T04:05:28.032581+00:00)

## What it is
A TypeScript package containing the JSON schema specification and utilities for Uniswap token lists, which are JSON blobs of ERC20 token metadata for use in dApp interfaces. It enables authoring and validating token lists that conform to the specification.

## Use cases
- validate a token list JSON against the Uniswap schema
- create a custom token list for a dApp interface
- fetch and check ERC20 token metadata lists
- integrate token list support into a DeFi frontend
- author tokenlist. files with editor schema validation

## When to choose
- building a dApp that needs curated ERC20 token metadata lists
- publishing or maintaining a token list compatible with Uniswap
- validating token list JSON files programmatically

## When to avoid
- you need on-chain token data fetching or price feeds
- you need token validation code beyond schema checking (bring your own validator like ajv)
- your project is not Ethereum/ERC20 related

## Facets
- artifact type: library
- maturity: stable
- function: serialization, sdk, developer-tools
- domain: blockchain, apis, developer-tools
- platform: -
- tags: erc20, token-lists, -schema, uniswap, defi, ethereum, cryptocurrency, typescript, nodejs, web-server

## Member repositories
- Uniswap/token-lists (main) score 55

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:28.032581+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:33:53.954703+00:00, confidence not recorded.
  - readme: https://github.com/Uniswap/token-lists (fetched 2026-08-28T04:05:28.032581+00:00, sha 224cc017163d)
  - homepage: https://tokenlists.org (fetched 2026-08-29T11:09:37.082257+00:00, sha 7ff8f5590444)
- Data as of 2026-08-30T08:39:29.467469+00:00.