
图:tokenlists.org 首页,Token Lists 标准的公开列表目录(2026-11 截图)
定位与基本信息
TokenLists(tokenlists.org)不是一个产品,而是一套开放标准加一个目录站。标准部分叫 Token Lists,由 Uniswap 团队提出并维护,规定用一份 JSON 文件来描述「某个机构背书的一组代币」:每个代币写明合约地址、所在链、符号、小数位数与图标链接。目录站 tokenlists.org 则把公开的列表集中展示,供钱包和交易界面挑选订阅。2026-11 快照:官网正常访问,首页标题自述为「Ethereum token lists(以太坊代币列表)」;规范仓库 Uniswap/token-lists 在 GitHub 上约 1.7k 星,仓库创建于 2020 年 6 月。它解决的问题很具体:去中心化交易界面不能像中心化交易所那样自建上币审核团队,于是把「哪些代币可信」外包成可订阅、可替换的公开列表。
平台背景
2020 年 DeFi 夏季里,Uniswap 界面上的代币靠用户粘贴合约地址添加,假币与仿冒代币泛滥。Uniswap 借鉴传统金融里「清单」思路推出 Token Lists 标准:任何机构(项目方、数据站、社区)都可以发布自己的列表,界面方自由选择信任哪些列表,责任与信誉归发布者。此后这套格式被大量钱包、聚合器与数据站采纳,成为 EVM 生态事实上的代币元数据分发格式。标准的规范、JSON Schema 与示例都开源在 GitHub 的 Uniswap/token-lists 仓库,tokenlists.org 由 Uniswap 团队维护,作为中立的发现入口存在至今。
理解这套标准,先要理解它出现的场景。2020 年以前,DEX 界面想展示一个代币,只能自己维护一份白名单,既中心化又跟不上新币发行速度;用户想交易名单外的代币,就得手动粘贴合约地址,而搜索同名代币时跳出来的第一个结果经常是仿冒合约。Token Lists 的解法是把「名单」变成一种公共品:名单的制作方对名单负责并公开接受检验,名单的消费方(界面、钱包)可以同时订阅多份名单并允许用户增删,出了问题可以追责到名单维护者而不是界面方。这套「发布—订阅」的信任分发方式,后来也被 NFT、跨链桥代币等其他元数据场景借鉴。规范仓库里同时提供 JSON Schema、校验工具与示例列表,任何人都可以照着格式发一份自己的名单,不需要向 Uniswap 申请许可。
核心服务与功能
第一层是标准本身:列表是一个带版本号的 JSON 文件,可托管在任意 HTTPS 地址、IPFS 或 ENS 域名下,字段包括列表名、时间戳、版本与代币数组;代币条目含 chainId、合约地址、name、symbol、decimals、logoURI,并支持扩展字段。第二层是目录站:在 tokenlists.org 可以按名称浏览、搜索已收录的公开列表,查看每份列表包含哪些代币,再决定是否在自己使用的界面里启用。第三层是生态集成:以 Uniswap 界面为例,它内置并默认启用若干受信任列表,用户也可以手动添加任意列表地址;Uniswap 自己的默认列表就以这套格式发布在 tokens.uniswap.org。第四层是治理属性:列表可更新、可废弃,版本号机制让订阅方能感知变更;不同列表的背书标准差异很大,从官方项目方列表到社区维护列表都有。

图:Token Lists 规范的官方 GitHub 仓库,含标准说明与 JSON 结构定义(2026-11 截图)
使用方式
普通用户:在钱包或 DEX 界面的代币选择处打开「列表管理」,查看当前启用了哪些列表,按需启用目录站里找到的列表,或粘贴列表地址(URL/ENS)手动添加;添加前应核对发布者官网与列表地址是否一致。开发者与机构:按规范仓库的 Schema 编写 JSON、托管到自己的域名或 IPFS,写明维护主体与更新策略,再向目录站与主流界面提交收录。整个流程不需要在 tokenlists.org 注册账号,也没有平台方的上币审核。
适用人群
- 在 DEX 交易、经常遇到「搜不到代币」或假币风险的普通用户,理解列表机制后能判断代币来源;
- 钱包、聚合器与交易界面的产品与开发团队,需要决定默认信任哪些列表;
- 代币项目方,需要把自家代币送进主流界面默认视野;
- 做代币元数据、图标与风险标注的数据服务商。
生态里常见的名单包括 Uniswap 官方默认列表、CoinGecko、1inch 等机构维护的列表,以及各类垂直社区名单;界面方一般默认启用少数头部名单、允许用户自加。名单之间并不互斥:同一个代币可以同时出现在多份名单里,信息冲突时以界面采用的名单为准。这也是为什么同一代币在不同钱包里显示的名称、图标甚至是否可见会不一致——差异不在链上,而在各自订阅的名单上。
免费与付费对照
这套标准与目录站对所有人免费:浏览列表、在界面里订阅列表、按规范发布自己的列表都不收费,规范文档与 Schema 全部开源。成本只发生在使用者自己一侧,例如托管 JSON 的域名与服务器、项目方维护列表的人力。需要注意,某些第三方数据服务会基于列表做增值产品并收费,那是它们各自的商业行为,与 Token Lists 标准本身无关。官网不存在会员、订阅或付费档位。

图:以 Token Lists 标准格式发布的 Uniswap 默认代币列表 JSON 文件(2026-11 截图)
优缺点
优点:
- 开放标准、无许可门槛,把上币背书从单个平台手里拆出来,市场竞争决定哪份列表可信;
- 格式简单(就是一份 JSON),托管与订阅成本都极低,六年下来成为 EVM 生态的事实标准;
- 用户可自由增删列表,不被某个界面的默认选择绑架;
- 版本与时间戳机制让变更可追溯,方便界面方做风险提示。
缺点:
- 目录站本身不做背书,被收录不等于代币安全,责任被推回给用户判断;
- 列表质量参差,长期无人维护、图标失效、代币已迁移合约的旧列表并不少见;
- 仿冒列表与钓鱼链接是现实风险,手动添加列表地址时最容易中招;
- 主要覆盖 EVM 链代币,非 EVM 生态(Solana 等)各有自己的注册表,标准并不统一。
同类竞品对比
| 对比项 | TokenLists | Etherscan | Uniswap |
|---|---|---|---|
| 定位 | 代币列表开放标准与目录 | 区块浏览器兼代币信息库 | 最大的去中心化交易协议与界面 |
| 代币信息从哪来 | 各机构自维护的 JSON 列表 | 浏览器自身收录与项目方提交 | 订阅 Token Lists 并内置默认列表 |
| 谁负责可信度 | 列表发布者,用户自选订阅 | Etherscan 平台审核与标签体系 | 界面默认列表加用户自定义 |
| 收费 | 标准与目录免费 | 浏览免费,API 分档收费 | 交易收协议费用,与列表无关 |
三者是协作而非替代关系:Uniswap 的界面正是靠订阅列表决定展示哪些代币;Etherscan 则提供另一套自上而下的代币档案与标签。理解 TokenLists,等于理解 DEX 界面里代币列表的来源逻辑。
对普通用户还有一条实操建议:在 Uniswap 等界面里第一次交易某个小代币时,先点开代币信息确认它来自哪份已启用列表、合约地址与项目官网公布的是否一致,再决定是否交易;如果某个代币只出现在不知名列表里、且与官方地址对不上,应当直接视为仿冒。项目方则要注意,列表的图标(logoURI)与名称同样会被仿冒者利用,把官方列表地址写进官网与文档的显眼位置,是成本最低的防伪手段。
还有一层常被忽略的事实:名单的「图标」字段指向的图片文件托管在发布者自己的服务器或 IPFS 上,图标加载失败、显示默认占位图并不罕见,遇到图标异常先核对列表原文与合约地址,不要单凭图标判断真伪。
注意事项与风险
第一,启用某份列表只是把它纳入搜索范围,不代表列表内代币经过审计或安全验证,交易前仍要核对合约地址与项目官网。第二,手动添加列表时只用发布者官网给出的地址,警惕社群里流传的仿冒列表链接。第三,老列表可能收录已废弃或已迁移的合约,发现代币信息异常时先看列表的更新时间与版本。第四,项目方维护列表要把私钥与发布权限管好,列表文件一旦被篡改,订阅它的所有界面都会同步展示错误信息,这类供应链风险已有先例。
数据统计
相关导航

