scallop-liquidation-helperlisted

# Liquidation Helper Find liquidatable positions and execute profitable liquidations on Scallop. ## Overview Liquidation occurs when an obligation's risk level reaches >= 1.0. Liquidators can repay debt and receive collateral at a discount (liquidation bonus). ## Liquidation Mechanics ### When Can Liquidation Occur? ``` risk_level = total_debt_value / (total_collateral_value * collateral_factor) If risk_level >= 1.0 → Position is liquidatable ``` ### Liquidation Bonus Liquidators receive collateral at a discount — e.g. repay $100 of USDC debt → receive ~$105 worth of SUI collateral. The bonus is a per-asset protocol parameter (5% SUI, 3% USDC, 5% wETH/wBTC) and can be changed by governance, so read it from protocol state rather than hardcoding it. ### Max Liquidation Amount - **Close Factor**: ~50% of debt can be liquidated per transaction - Multiple transactions may be needed for full liquidation Each transaction re-evaluates the position against the prices posted in it, so a position measured as liquidatable off-chain can be healthy by execution time and the call will fail. Full mechanics: [liquidation-flow.md](references/liquidation-flow.md). ## Find Liquidatable Positions ### Check Specific Obligation ```python query = client.create_query() # Check a known obligation for liquidation eligibility ob = query.get_obligation_with_prices(obligation_id) if ob.is_liquidatable: print(f"Obligation {ob.obligation_id} is liquidatable!") print(f"Risk Level: {o