DefiLlama MCP Data Reference 是 DefiLlama MCP 工具的核心参考，主要用于把各类 DeFi 问题对应到正确的工具调用，并使用合适的参数。
用途 它提供工具速查表，将问题映射到对应工具与关键参数：全局 DeFi TVL 与交易量使用 get_market_totals；协议 TVL、费用、收入使用 get_protocol_metrics；链 TVL、gas 费用、REV 使用 get_chain_metrics；代币价格、市值、ATH 使用 get_token_prices；类别排名使用 get_category_metrics；池 APY 与借贷利率使用 get_yield_pools；稳定币供应量使用 get_stablecoin_supply；ETF 流入流出使用 get_etf_flows；跨链桥交易量使用 get_bridge_flows；CEX 交易量使用 get_cex_volumes；未平仓合约使用 get_open_interest；黑客攻击与漏洞事件、融资、协议事件使用 get_events；协议金库使用 get_treasury；机构持仓使用 get_dat_holdings；代币解锁使用 get_token_unlocks；协议内代币 TVL 使用 get_token_tvl；预言机覆盖使用 get_oracle_metrics；用户活动使用 get_user_activity；损益表使用 get_income_statement；协议元数据与审计信息使用 get_protocol_info；链元数据与 L2 父链使用 get_chain_info；列出有效类别使用 list_categories；未知实体 slug 使用 resolve_entity。
主要能力 该参考详细说明实体约定：协议使用小写加连字符 slug（如 aave、uniswap、compound-v3）；链使用小写（如 ethereum、solana、arbitrum）；代币使用 coingecko: 前缀（如 coingecko:ethereum、coingecko:bitcoin、coingecko:usd-coin）；CEX 的 slug 含后缀（如 binance-cex、coinbase-cex、htx、gate-io）；类别使用首字母大写（如 Lending、DEX、Derivatives）。它还阐明父协议与子协议的区别：父协议用于 get_protocol_metrics 并聚合所有版本，子协议用于特定版本；resolve_entity 会同时返回 slug 与 parent_protocol。所有实体参数支持单值或数组以进行比较。周期参数统一使用 period 而非 time_range，支持 current 默认值、7d、30d、90d、180d、365d 滚动窗口，自定义日期范围使用 start_date 与 end_date（YYYY-MM-DD），仅设置 start_date 时默认截止到今天。
关键约定与解释 参考强调股票与流量的区别：股票类（时点快照）如 tvl、price、mcap 绝不跨日期求和；流量类（周期累计）如 fees_1d、revenue_1d、volume 可跨日期求和。百分比格式化有两种：*_pct_change 列为小数（如 -0.13 表示 -13%，0.35 表示 +35%），需乘 100 显示；apy 列已是百分比（如 2.32 表示 2.32%），不可再乘 100。TVL 各组成部分互斥，不可重复相加：tvl_base 为默认 TVL（不含流动性质押与重复计算），tvl_ls_only 为未含在 tvl_base 中的流动性质押部分，tvl_dc_only 为未含在 tvl_base 中的重复计算部分，tvl_ls_and_dc 为同时包含 LS 与 DC；含 LS+DC 的总量为四者之和。费用与收入定义：fees 为用户支付的总额，revenue 为协议分成（fees 减去支付给 LP/质押者的部分），holder_revenue 为回购与向代币持有者分红；链层面使用 chain_fees（gas）、chain_revenue、chain_mev、app_fees、app_revenue。指标名称模式：TVL 包括 tvl_base、tvl_staking、tvl_borrowed、tvl_pool2、tvl_treasury、tvl_vesting；流量后缀为 _1d/_7d/_30d/_90d/_180d/_365d/_ytd/_alltime/_annualised，适用于 fees、revenue、holder_revenue、incentive；交易量同样支持这些后缀，适用于 volume_dexs、volume_aggregators、volume_derivatives、volume_aggr_derivatives、volume_options；市场指标包括 price、mcap、fdv、fdv_outstanding、token_volume、ps_ratio、pf_ratio；pct_change 变体仅在 _current 视图可用；链指标使用 chain_fees、chain_revenue、chain_mev、app_fees、app_revenue 而非 fees、revenue；每日视图仅提供 _1d 后缀的流量与交易量。
使用方式与示例 参考提供示例：问 Aave 的 TVL 时调用 get_protocol_metrics(protocol: "aave", metrics: ["tvl_base"])；问费用最高的前 5 条链时调用 get_chain_metrics(sort_by: "chain_fees_1d desc", limit: 5)；问 ETH 过去 90 天价格历史时调用 get_token_prices(token: "coingecko:ethereum", period: "90d")；比较 ETH 价格与以太坊链 TVL 时并行调用 get_token_prices 与 get_chain_metrics；问今年最大 DeFi 黑客事件时调用 get_events(event_type: "hacks", sort_by: "amount desc", limit: 10, period: "365d")；问 Aave 2025 年 1 月至 3 月 TVL 时调用 get_protocol_metrics(protocol: "aave", metrics: ["tvl_base"], start_date: "2025-01-01", end_date: "2025-03-31")。错误恢复：返回 0 行时调用 resolve_entity 获取正确 slug 后重试；数据错误时检查是否使用了正确工具（协议、链或类别）；实体含糊时先调用 resolve_entity 查看所有匹配 slug 再选择。
重要陷阱 get_protocol_metrics 没有 category 列，类别层面数据应使用 get_category_metrics；不要按 FDV 排序，因为 total_supply 数据不可靠会产生垃圾排名，应按 mcap 排序；估值方面 ps_ratio = mcap / 年化收入，pf_ratio = mcap / 年化费用，越低可能越低估；协议/链/类别指标会与实际数据库列校验，无效指标会返回最接近匹配的建议；NULL 表示数据不可用，而非 0，不要把 NULL 报告为零；参数接受字符串或数组，参数名为单数（如 protocol 而非 protocols）；sort_by 格式为类似 "tvl_base desc" 或 "fees_1d desc" 的字符串。
适用场景与限制 适用场景包括需要将 DeFi 数据问题准确映射到 DefiLlama MCP 工具调用、理解指标含义与聚合规则、避免常见数据处理错误的开发者与分析师工作。限制方面，资料未说明该技能的收费、价格、平台支持范围或效果保证，也未提供官方文档链接之外的使用步骤，暂未提供相关内容。