Token Research 用于对代币执行端到端分析，把价格数据、解锁时间表、DeFi 存款追踪、收益机会和协议基本面组合在一起。
用途 当用户要求分析某个代币时，该技能输出一份覆盖多个维度的结构化报告，帮助了解代币当前的市场表现、未来可能出现的供应变化、在 DeFi 中的实际使用情况以及可获得的收益。
工作流程
第 1 步 · 解析代币实体 获取规范的代币标识（coingecko:xxx 格式）。
defillama:resolve_entity entity_type: "token" name: "<user-provided name>"
第 2 步 · 价格与市场数据 获取当前价格、市值、成交量以及 ATH。
defillama:get_token_prices token: "coingecko:token_id"
关键字段：price、mcap、volume、price_ath。距 ATH 的距离可按 (price_ath - price) / price_ath 计算。
第 3 步 · 解锁时间表 检查归属计划与即将到来的代币解锁，它们可能带来抛压。
defillama:get_token_unlocks token: "<token_name>"
将未来 30 天内的重大解锁标记为潜在抛压。
第 4 步 · DeFi 存款 查看该代币在各类 DeFi 协议中的存款情况。
defillama:get_token_tvl token: "coingecko:token_id"
使用 dim.token_set() 进行家族解析（例如 coingecko:ethereum 可匹配 ETH、wETH、stETH 等）。component 参数按 TVL 类型过滤（base、borrowed、staking、pool2、treasury、vesting）。系统会应用质量过滤器（is_distressed、has_misrepresented_tokens）。
这展示哪些协议持有该代币最多，从而反映 DeFi 需求与实用性。
第 5 步 · 收益机会 查找用户可以用该代币赚取收益的池子。
defillama:get_yield_pools token: "coingecko:token_id"
token 参数需要规范键（例如 coingecko:ethereum）。使用 dim.pool_set() 进行家族匹配。
第 6 步 · 协议基本面（如适用） 如果该代币属于某个 DeFi 协议，获取协议的指标。
defillama:get_protocol_metrics protocol: "<protocol_slug>"
输出格式 按以下顺序分段呈现报告：
价格与市场 — 当前价格、市值、24 小时成交量、距 ATH 的距离以及近期趋势。
解锁时间表 — 即将到来的解锁及其日期、数量、占流通供应的百分比。重点标出任何悬崖式解锁（cliff unlocks）。
DeFi 存款 — 持有该代币的主要协议、存款总价值，以及这对其实用性意味着什么。
收益机会 — 按 APY 和 TVL 排序的前 3-5 个可供部署该代币的池子。
协议基本面 — 如果该代币是协议治理或实用代币，则包含 TVL、费用、收入和估值比率。
提示 30 天内超过流通供应 2% 的大额解锁是重大风险因素。 相对于流通供应而言较高的 DeFi 存款，表明持有者信念较强、可流通供应减少。 比较收益 APY 来源：来自费用的基础 APY 可持续，来自代币排放的奖励 APY 不可持续。 如果该代币没有解锁数据，可能已完全解锁，或相关数据未被追踪——请向用户说明这一点。 价格和 TVL 查询可使用 start_date / end_date 自定义日期范围。
适用场景 需要在一次分析中同时掌握某代币的行情、供应解锁风险、链上 DeFi 需求与收益机会时使用。
限制 该技能依赖 defillama 相关工具返回的数据；若某代币缺少解锁数据，报告需注明可能已完全解锁或数据未被追踪。关于收费、价格、支持平台等信息，资料中暂未提供。