hodlmm-risk

Assess HODLMM pool volatility risk and return structured JSON signals.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill hodlmm-risk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hodlmm-risk
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/hodlmm-risk
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill hodlmm-risk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.

What problem does it solve?

LPs in Bitflow HODLMM pools need a guardrail to avoid risky liquidity moves. This skill provides a read-only risk gate by evaluating pool state, scoring volatility, and surfacing action-relevant signals.

Core Features & Use Cases

  • Read-only risk assessment for HODLMM pools on mainnet.
  • Regime classification (calm, elevated, crisis) with actionable recommendations for liquidity actions.
  • Subcommands to assess pool, assess position, and retrieve regime snapshots for monitoring.

Quick Start

Run the risk assessment for a pool with bun run hodlmm-risk/hodlmm-risk.ts assess-pool --pool-id < pool_id >.

Frequently Asked Questions about hodlmm-risk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess liquidity pool volatility risk for HODLMM positions?

To assess liquidity pool volatility risk, run the assess-pool subcommand with your target pool ID. It evaluates the HODLMM pool state, calculates a volatility proxy score, and outputs structured JSON containing the regime classification and actionable LP signals.

What is a volatility regime in DeFi liquidity provision?

A volatility regime in DeFi liquidity provision classifies current pool market conditions into calm, elevated, or crisis states. By analyzing reserve imbalance and bin spread, it guides liquidity providers on whether to add, hold, or withdraw assets.

How do I check my active liquidity position risk in a Binflow HODLMM pool?

Check your active liquidity position risk by running the assess-position subcommand. It evaluates your specific liquidity against the active bin ID and total bin spread to generate targeted holding or withdrawal recommendations based on the current volatility score.

Does the HODLMM risk signal tool execute liquidity withdrawals or trades?

No, the HODLMM risk signal tool is strictly read-only. It evaluates on-chain pool state and surfaces action-relevant signals to guide liquidity decisions, but it does not execute trades, add liquidity, or withdraw funds automatically.

Can I monitor HODLMM pool regime changes over time using a snapshot?

Yes, you can retrieve a regime snapshot using the regime-snapshot subcommand. It provides a timestamped JSON output of the pool's network, active bin ID, volatility score, and current regime classification to track risk changes over time.