用途：为 Bitflow HODLMM 集中流动性池提供 Swap 流量情报。与其他关注池状态的工具不同，它关注实际成交的方向、主体及其对 LP 的影响，帮助智能体在缺乏流量分析时避免盲选区间参数。
主要能力：从 Hiro API 获取链上 Swap 交易，解析 DLMM 核心合约事件，提取逐 bin 跳跃的成交量，并计算六项市场微结构指标——方向偏差、流量毒性、bin 速度、巨鲸集中度、清算压力、机器人/有机分类。最终输出 LP 安全判定、评分、理由、建议及预测的区间存续小时数。可检测毒性流、预测区间寿命、识别交易主体（机器人/有机/清算者）、评估方向性风险、发现清算级联。
使用方式：运行命令如 bun run hodlmm-flow/hodlmm-flow.ts doctor 检查连通性；bun run hodlmm-flow/hodlmm-flow.ts flow --pool-id dlmm_3 分析单池最近 100 笔 Swap；加 --window 24h 做时间窗分析；--all 汇总全部 8 个池；--swaps 指定数量；--hiro-api-key 提升限额。所有输出为 JSON。
适用场景：智能体评估 LP 区间参数、监控主网 HODLMM 池的流量结构与风险。
限制：只读，不提交交易或转移资金，无需钱包。仅主网。免费 Hiro 每次约支持 100 笔 Swap，更大分析需 API key。池合约交易中仅约 25-30% 为 Swap，工具需翻页收集。Hiro 索引有约 1-2 个区块延迟，极新交易可能未出现。Bitflow 目前未提供 Swap 历史 API。