HODLMM Risk Skill

What it does

Monitors HODLMM (DLMM) pool volatility and LP risk on Bitflow. Computes bin spread, reserve imbalance, and concentration metrics to classify market regime and emit position-sizing signals.

Why agents need it

Agents managing HODLMM liquidity need a risk gate before adding, holding, or withdrawing. This skill provides that gate — a numeric volatility score and regime label that downstream agents can use to decide whether to act.

Safety notes

• Read-only — never writes to chain or moves funds.
• Mainnet only — Bitflow HODLMM APIs are mainnet-only.
• No wallet or funds required.
• Pools with all-zero reserves return an error rather than misleading metrics.

Commands

assess-pool

Assess volatility and risk metrics for a HODLMM pool.

bun run hodlmm-risk/hodlmm-risk.ts assess-pool --pool-id <pool_id>

Options:

• --pool-id (required) — HODLMM pool identifier (e.g. dlmm_3)