用途
Token Movers 是一个加密货币市场扫描与单币分析工具，用于快速识别市场中的真实信号与噪音。它提供两种行为模式：
- movers：扫描涨幅榜、跌幅榜、热门币，或链上跑赢者（runners），并标注拉盘风险。
- single-token：对指定代币生成深度报告。
主要能力
双数据源
- CoinGecko：按市值排名的市场数据，提供 1 小时、24 小时、7 天涨跌幅，以及热门搜索币种。
- GeckoTerminal：链上数据，覆盖主要链的 trending pools、成交量领先池和新池。
范围限定
- 按链限定：支持 solana、eth、ethereum、base、bsc、arbitrum、polygon、optimism、avalanche、avax。
- 按类别限定：如 category:layer-2、category:meme。
- 单币查询：通过合约地址（EVM 0x 地址或 Solana base58 地址）或代币符号（如 SOL、WIF）解析。
过滤与评分
- CoinGecko 路径：排除稳定币与 24 小时成交量低于 100 万美元的低流动性代币，再排序选出涨幅榜、跌幅榜和热门币。
- GeckoTerminal 路径：按 base token 去重，通过质量门槛（成交量、流动性、买卖比、池创建时间、涨跌幅上限）过滤，再计算 Runner Score（0-100），综合涨跌幅、成交量、流动性、动量和买压。
信号与风险标签
CoinGecko 路径标签包括：TRENDING+UP、TRENDING+DOWN、BREAKOUT、FADE、CAPITULATION、PUMP-RISK、MICROCAP、MAJOR。
GeckoTerminal 路径标签包括：DEEP-LIQ、BREAKOUT、CONTINUATION、REVERSAL、MICRO-SPEC。
输出
- 通过 ./notify 发送通知，包含市场脉搏一句话、涨幅榜、跌幅榜、热门币和值得注意的信号。
- 将结果追加到 memory/logs/ 日志，并读取前几日日志以避免重复，同时标记重复出现的 runner。
使用方式
通过变量 ${var} 选择扫描模式，规则自上而下匹配，首个匹配生效：
- 空值 → movers 扫描，默认 CoinGecko 源。
- coingecko → movers 扫描，CoinGecko 源。
- geckoterminal → movers 扫描，GeckoTerminal 源，覆盖主要链。
- geckoterminal:<chain> 或裸链名 → GeckoTerminal runners，限定该链。
- category:<name> 或带连字符/空格的裸值 → CoinGecko movers，限定该类别。
- <contract> 或 <contract>:<chain> → 单币深度报告。
- <SYMBOL> → 单币深度报告，先解析符号到其顶级合约。
- token / single-token → 对 memory/token-report.md 中配置的代币生成单币深度报告。
- deep-dive:<symbol|contract> → 单币深度报告，Telegram 强制回复使用的格式。
示例：""（全局 movers）、geckoterminal:base（Base runners）、category:layer-2（L2 movers）、0x4ed…:base 或 WIF（单币报告）。
每次运行前会读取 memory/MEMORY.md 获取上下文，并读取最近 2 天日志以避免重复。
适用场景
- 快速了解加密货币市场整体走势与热点。
- 发现链上跑赢者并评估其质量与风险。
- 对特定代币进行深度分析。
- 通过 Telegram 强制回复触发单币报告。
限制
- CoinGecko 免费/Demo key 使用 x-cg-demo-api-key 头，无 key 时公共端点可用但速率限制更低；付费 Pro key 使用 pro-api.coingecko.com 和 x-cg-pro-api-key 头。
- GeckoTerminal API 免费且无需 API key，但需注意速率限制，代码中包含退避重试。
- 所有数值阈值（如成交量门槛、标签条件）为起始启发值，可根据需要调整。
- 输出不包含预测，仅基于数据描述。
- 部分功能（如具体收费、价格、平台支持）暂未提供。