{"uid":"cap_LMFrskrR0OP4LnkehO6E0","slug":"nonvisceral-eloisa-mousily-ngrok-free-dev-3dce19b4","name":"Kerdos Liquidation Cascade Risk API","description":"Liquidation cascade risk API: decision-ready risk level (NONE/LOW/MODERATE/ELEVATED/HIGH) per coin, plus recommended position-size-discount and entry-threshold-boost used internally by the Kerdos trading fleet. Direct complement to /api/liquidations — liquidations gives you raw data, cascade-risk gives you the classification and action recommendation. Monopoly: derived from OI velocity + large-trade clustering + liquidation cluster count on Hyperliquid.","url":"https://nonvisceral-eloisa-mousily.ngrok-free.dev/api/cascade-risk","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"per_coin":{"type":"object","description":"Per-coin cascade level + severity + raw drivers + recommended notional-mult and threshold-boost"},"fleet_max":{"type":"object","description":"Highest severity across all tracked coins — use as single gate for portfolio-wide risk"},"updated_at":{"type":"string"},"methodology":{"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"per_coin":{"BTC":{"level":"NONE","severity":0,"oi_change_1h_pct":0.179,"oi_change_15m_pct":null,"large_trades_count":null,"liquidation_cluster_count":null,"recommended_notional_mult":1,"recommended_threshold_boost":0},"ETH":{"level":"NONE","severity":0,"oi_change_1h_pct":0.316,"oi_change_15m_pct":null,"large_trades_count":null,"liquidation_cluster_count":null,"recommended_notional_mult":1,"recommended_threshold_boost":0},"SOL":{"level":"NONE","severity":0,"oi_change_1h_pct":-0.034,"oi_change_15m_pct":null,"large_trades_count":null,"liquidation_cluster_count":null,"recommended_notional_mult":1,"recommended_threshold_boost":0}},"fleet_max":{"level":"NONE","severity":0},"updated_at":"2026-04-19T04:28:40.485303+00:00","methodology":"Cascade level derived from open-interest velocity + large-trade clustering + liquidation cluster count on HL. Used internally by the Kerdos trading fleet to dampen entry threshold and shrink position notional during cascade conditions."}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_s_Wz2czkVGQ5tzFC8aIHd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns decision-ready liquidation cascade risk levels (NONE/LOW/MODERATE/ELEVATED/HIGH) per coin with recommended position-size discounts and entry-threshold boosts, derived from OI velocity, large-trade clustering, and liquidation cluster counts on Hyperliquid.","exampleAgentPrompt":"What's the current liquidation cascade risk level for BTC, ETH, and SOL right now — and what position-size multiplier and entry-threshold boost does Kerdos recommend based on OI velocity and liquidation clustering on Hyperliquid?","exampleUseCases":null,"resultDescription":"A JSON object with per-coin cascade risk classification (level: NONE/LOW/MODERATE/ELEVATED/HIGH), severity score, OI change percentages (1h and 15m), large trade count, liquidation cluster count, recommended notional multiplier, and recommended entry threshold boost — plus a fleet_max field summarizing the highest risk level across all tracked coins, an updated_at timestamp, and a methodology string.","failureModes":["Service unavailable or ngrok tunnel offline — returns 5xx or connection error","No data available for a requested coin — field may be null or coin absent from per_coin map","Stale data — updated_at timestamp may lag if upstream Hyperliquid data feed is delayed","Payment not processed (x402 protocol failure) — returns 402 with payment required details","Null values for oi_change_15m_pct or large_trades_count when sub-interval data is not yet populated"],"whenToPreferThis":"Use this endpoint when you need actionable, pre-classified risk recommendations (not raw liquidation data) for automated trading decisions — specifically when you want the Kerdos fleet's internal position-size-discount and entry-threshold-boost parameters derived from Hyperliquid OI velocity and liquidation clustering. Prefer this over raw /api/liquidations when you want decision-ready output rather than raw numbers to classify yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:59.470Z","isFirstParty":false}