# Jumper 搜不到代币：按链、合约地址和路线条件排查

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/jumper-token-address-list-route-check
难度：入门
核验方式：官方文档整理，未执行真实账户操作

把名字未收录与无流动性、无报价分开，避免把默认列表当全部支持范围。

## 使用工具
- [Jumper](https://lianxiaozhi.com/tools/jumper) · [官方入口](https://jumper.xyz/)

## 前置条件
- 准备要查询的网络、代币合约地址，以及已有搜索结果或无报价提示；合约地址从项目官方资料和对应链记录核对。
- 本教程依据公开文档，当前动态界面未实测；不连接钱包或执行兑换。

## 1. 先固定网络与合约地址

先核网络和合约地址，再检查符号/名称。LI.FI 官方帮助明确给出 Jumper 的方法：在代币搜索字段输入代币地址；同名资产不能仅靠符号判断身份。

当前公开仓库已经归档、应用入口已转向 jumper.xyz。若页面无法加载或找不到文档所述字段，保留访问/版本问题，不把它判成代币不支持。

核对结果：记录链和地址；页面不可读时结论为未验证。
依据：[LI.FI 官方帮助：Jumper 按代币地址查找与默认列表](https://help.li.fi/hc/en-us/articles/11303402217371-I-can-t-find-my-token-How-can-I-get-LI-FI-to-support-my-token)
依据：[Jumper 官方仓库：冻结说明与当前入口](https://github.com/jumperexchange/jumper-exchange)

## 2. 分别记录名字和地址搜索的结果

默认 /tokens 列表经过有效性、已知列表、垃圾币和价格等筛选；缺少名字结果不证明链上不存在该资产。官方说明按地址会查找链上资产与可用流动性，默认列表收录才使名字在 Jumper 全局可搜。

地址也没有结果时，先复核所选链与合约身份，记录原错误或空结果；未验证的地址搜索不能写成支持所有代币。

当前Token Support页允许 verificationStatus 为 verified、unverified 或 flagged；flagged 可被钱包余额结果省略却仍出现在 /tokens。风险筛选标签不决定路由资格，列表出现也不等于安全背书。

核对结果：名字未收录、地址识别和可用流动性三项分开；空结果不填“已支持”。
依据：[LI.FI 官方帮助：Jumper 按代币地址查找与默认列表](https://help.li.fi/hc/en-us/articles/11303402217371-I-can-t-find-my-token-How-can-I-get-LI-FI-to-support-my-token)
依据：[LI.FI Token Support：列表、地址发现与应用范围](https://docs.li.fi/faqs/token-support)

## 3. 把找到资产和获得报价分开

识别代币后仍无报价，应核原记录的来源链、目标链、数量、地址及错误。LI.FI 文档明确：Solana 钱包没有 SOL 会被阻止返回报价，以避免 rent/Gas 失败；此条件不代表代币已下架。

文档也说明缺 USD 价格可能受 maxPriceImpact 过滤。该配置属于集成方 SDK，不据此指导用户放宽 Jumper 风险参数；无具体提示时，资金、价格数据或流动性原因保持待核。

核对结果：资产搜索结果与无报价提示分别有记录；不把 SDK 配置当应用已提供的按钮。
依据：[LI.FI Route Availability：无报价与资金/路由条件](https://docs.li.fi/faqs/route-availability)
依据：[LI.FI Token Support：列表、地址发现与应用范围](https://docs.li.fi/faqs/token-support)

## 4. 区分局部配置和全局收录

官方区分自有 Widget 的 tokens 配置与 LI.FI/Jumper 全局名单：前者只作用于该集成，后者通过 lifinance/customized-token-list 的收录流程。发现别人 Widget 有某代币，不推断 Jumper 已全局收录。

完成时留下链/地址、名字结果、地址结果、报价条件和待核项。本文只解释资料中的收录路径，没有提交名单申请，也没有以收录替代代币风险检查。

核对结果：缺口归到身份、名单、访问或路线条件；未知项保留。
依据：[LI.FI Token Support：列表、地址发现与应用范围](https://docs.li.fi/faqs/token-support)
依据：[LI.FI 官方帮助：Jumper 按代币地址查找与默认列表](https://help.li.fi/hc/en-us/articles/11303402217371-I-can-t-find-my-token-How-can-I-get-LI-FI-to-support-my-token)

## 常见错误
- 旧帮助页里的支持数量和历史路由参数不是今日全链可用承诺。
- 社区仿冒域名不作为官方入口；应用费率在取得当前官方资料前保持待核。

## 完成检查
- 形成链/地址、名字列表、地址发现及报价条件的对照。
- 无法访问应用或缺少原错误时标注未验证，而非认定不支持。

## 相关知识
- [跨链显示已发送却未到账？来源交易、消息与目标执行分开查](https://lianxiaozhi.com/learn/bridge-transfer-status)

## 官方依据
- [Jumper 官方仓库：冻结说明与当前入口](https://github.com/jumperexchange/jumper-exchange)
- [LI.FI 官方帮助：Jumper 按代币地址查找与默认列表](https://help.li.fi/hc/en-us/articles/11303402217371-I-can-t-find-my-token-How-can-I-get-LI-FI-to-support-my-token)
- [LI.FI Token Support：列表、地址发现与应用范围](https://docs.li.fi/faqs/token-support)
- [LI.FI Route Availability：无报价与资金/路由条件](https://docs.li.fi/faqs/route-availability)