用途
Meteora DLMM pool screening 用于为用户筛出并排序 Meteora DLMM 流动性池候选名单，帮助选择适合做 LP 的池子与 bin step。它适合“给出一份排名表并做判定”的场景；不适合单池深度分析、部署、领取、关闭仓位、兑换、钱包管理等执行类任务，也不做代币持有人或叙事研究。
主要能力
- 发现范围：默认按 category=trending 发现热门池；用户指定代币时按 mint/符号查询。
- 硬过滤：先剔除不合格池子再排序，包括死池（零成交量且零 fee/TVL），以及除 loose 外各预设下对关键代币警告、单一持仓过高、非 DLMM 池类型的拒绝。
- 评分公式：fee_active_tvl_ratio * 1000 + organic * 10 + volume / 100 + holders / 100，以 fee/TVL 为主导，organic 与活跃度用于区分。
- 判定：pass（通过门槛且排名靠前）、watch（通过门槛但活跃度低、代币未验证或 bin step 不理想）、skip（未通过门槛）。
- 预设：volatile（默认，bin_step 80–125、TVL 10k–150k、min fee/active TVL 0.05、min organic 60、min holders 500、min volume 500）、stable（bin_step 1–50、TVL 100k–5m、0.02、70、2000、5000）、bluechip（bin_step 1–25、TVL 500k–10m、0.01、80、5000、10000）、loose（任意 bin step、TVL ≥1k、其余门槛为 0）。
- 时间窗口：默认 30m，可选 5m（噪声更大）或 24h（更平滑但滞后）；报告中需标注时间窗口。
- 输出：包含协议的 tvl、vol_24h、池数量，排名表（名称、bin、fee/TVL、tvl、vol、organic、holders、判定、理由），以及被拒样本与原因，并引用池地址。若返回零行，应说明并逐项放宽一个门槛（通常是 maxTvl 或 minFeeActiveTvlRatio），不得编造池子。
使用方式
内嵌筛选脚本仅用标准库，只做只读 GET。将源码复制到临时目录（如 mktemp -d），用 Python 3.10+ 运行，完成后删除副本。示例命令：
python3 screen.py # trending volatile（默认） python3 screen.py --preset stable python3 screen.py --query BONK # 交易对搜索，预设默认为 loose python3 screen.py --query BONK --preset volatile python3 screen.py --json --limit 8
若不使用脚本，可按参考资料中的公开端点用 curl 获取。请求必须发送 User-Agent，否则未认证请求会返回 403。交易对查询默认使用 loose，以便比较不同 bin step；仅在用户明确要求时指定 --preset volatile。loose 仅用于交易对比较或空结果调试，不适合作为实际 LP 选择。
适用场景
用户想要热门的或指定代币/交易对的 Meteora DLMM 排名候选表；询问某交易对该选哪个 bin step 或池子；需要基于 fee/TVL 的批量筛选而非单池深挖。完成后应停在排名表与判定处，不获取钱包、不构建交易、不调用 Etemaro CLI。
限制与安全
工具完全只读，仅 GET 公开 Meteora JSON，不涉及 .env、keystore、签名、部署、兑换、领取或关闭；如需实际执行，资料指向 Etemaro 项目（https://github.com/romankurnovskii/etemaro）。依赖 Meteora 公开 datapi 端点，该端点无文档、有限流，可能随时变更或消失，本工具与 Meteora 无关联。所有指标均为窗口化（默认 30m），fee/TVL 不等于 24h APR，历史收益不预示未来收益；未建模无常损失、bin step 漂移与成交风险。代币评分依赖第三方 organic score 与持有人字段，对新币或低流动性代币可能过时、被操纵或出错。筛选结果仅供参考，不构成财务建议，pass 判定不代表建议入金。应遵守公开 API 使用规范，发送 User-Agent 并保守轮询。