| name | venus-protocol-ops |
| description | Analyze Venus Protocol lending/borrowing positions on BNB Chain with risk-first guidance. Use when users ask about Venus markets, collateral/borrow decisions, health factor, liquidation risk, APY/utilization comparison, isolated pools, or "can I borrow X safely" style what-if checks. |
Venus Protocol Ops
Overview
Use this skill to provide read-only, risk-aware analysis for Venus Protocol. Prioritize liquidation safety, clarity, and explicit uncertainty over aggressive yield-chasing.
Workflow
1) Classify user intent
Map request into one of these modes:
- Market scan: compare assets/pools (supply APY, borrow APY, utilization, caps)
- Position check: assess a wallet's current collateral/borrow health
- What-if simulation: estimate risk after a proposed borrow/supply/repay
- Execution planning: prepare step-by-step actions without broadcasting tx
If user asks for onchain execution, pause and request explicit confirmation + exact parameters. Use simulation first, then broadcast only after user confirms.
2) Collect data
Use scripts first:
scripts/fetch_markets.py for market snapshot (official API base: https://api.venus.io, default scope: Core Pool only via references/pool-filter.json)scripts/wallet_onchain_exposure.py for real wallet onchain exposurescripts/check_wallet_exposure.py for manual/API fallback wallet summaryscripts/simulate_borrow.py for hypothetical borrow impactscripts/venus_deposit.js for deposit preview/broadcast flow (approve + mint)scripts/venus_withdraw.js for withdraw preview/broadcast flow (redeem / redeemUnderlying) with post-withdraw HF prediction and safety line checks (default 1.2, user customizable)scripts/venus_borrow.js for borrow preview/broadcast flowscripts/venus_repay.js for repay preview/broadcast flow (approve + repayBorrow)scripts/venus_collateral.js for collateral enable/disable (enterMarkets / exitMarket)scripts/hf_monitor.py for threshold-based HF monitoring and advisory actions (includes ACCOUNT_UNHEALTHY alert when HF < safety line, default 1.2)
Example market query:
python scripts/fetch_markets.py --chain-id 56 --limit 200 (Core Pool default)python scripts/fetch_markets.py --chain-id 56 --limit 200 --pool-scope all (all pools)
If API is unavailable, continue with transparent assumptions and mark output as estimate.
3) Run risk rules
Apply rules from references/risk-rules.md:
- Compute health and safety buffer
- Flag borrow-cap / liquidity constraints
- Detect concentration risk (single volatile collateral)
- Classify risk: Low / Medium / High
4) Produce actionable output
Always include:
- Current state (key numbers)
- Risk status (Low/Medium/High + why)
- Safe range (max suggested extra borrow or required extra collateral)
- Next best actions (2-4 concrete steps)
Prefer concise bullets and exact numbers.
Output format
Use this structure:
- Summary: one-line verdict
- Metrics: collateral, debt, health, utilization, APYs
- Risk findings: top 2-4 risks
- Recommended plan: concrete steps and limits
- Assumptions: data freshness, missing fields, estimate flags
Guardrails
- Never claim guaranteed safety or returns.
- Never hide data gaps; explicitly note stale/missing data.
- Default to conservative thresholds when uncertain.
- Treat this as educational/risk tooling, not financial advice.
- For real transactions: run simulate mode first; require explicit confirmation for broadcast.
- For withdrawals: always predict post-withdraw HF; warn/block when predicted HF falls below safety line (default 1.2 unless user customizes).
Quick usage
- One-command market check:
python scripts/venus_check.py --symbol vUSDT
- Market + auto wallet risk check:
python scripts/venus_check.py --symbol vUSDT --wallet 0x...
- What-if borrow (auto wallet):
python scripts/venus_check.py --symbol vUSDT --wallet 0x... --extra-borrow 120
- Manual fallback:
python scripts/venus_check.py --symbol vUSDT --wallet 0x... --weighted-collateral 1500 --debt 1000
- English brief mode:
python scripts/venus_check.py --symbol vUSDT --wallet 0x... --output brief --lang en
Protocol separation
- Venus Core scripts:
scripts/ root (e.g. venus_*.js, fetch_markets.py, wallet_onchain_exposure.py).
- Flux (Power by Fluid) scripts:
scripts/flux/.
- Choose protocol-specific scripts directly so other agents can route quickly without mixing workflows.
References
- Protocol overview:
references/protocol-overview.md
- Risk thresholds and formulas:
references/risk-rules.md
- Contract/address notes:
references/bnbchain-contracts.md
- Terminology:
references/glossary.md
- Venus CLI cookbook:
references/quick-commands.md
- Flux CLI cookbook:
references/flux-quick-commands.md
- Flux BNB addresses:
references/flux-bnb-addresses.json
