{"uid":"cap_b9f3_jP5Lp3hUHzTVDbDd","slug":"forgemesh-futures-risk-analyzer-105d9239","name":"ForgeMesh Futures Risk Analyzer","description":"Answers 'will this leveraged perp position survive the calibrated range?' for a side, entry, and leverage you specify: liquidation price and distance, the adverse 80%-range bound, a SURVIVES_RANGE / THIN_BUFFER / LIQUIDATION_INSIDE_RANGE verdict, the max leverage that still survives, P&L at both range bounds, and funding cost over the horizon — use it as a pre-trade gate or to stress an open position.","url":"https://crypto.forgemesh.io/api/kronos/futures/risk?utm_source=zero.xyz","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","required":["side","leverage"],"properties":{"side":{"enum":["LONG","SHORT"],"type":"string"},"entry":{"type":"number","description":"Entry price (defaults to current perp mark)"},"symbol":{"type":"string","description":"BTC, ETH, SOL, XRP, or ADA"},"leverage":{"type":"number","description":"Leverage to test, e.g. 3"},"notional":{"type":"number","description":"Position notional in USD for funding cost (optional)"},"horizon_hours":{"type":"number","description":"Hours held for funding cost (default: forecast horizon)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"verdict":{"enum":["SURVIVES_RANGE","THIN_BUFFER","LIQUIDATION_INSIDE_RANGE","UNKNOWN_RANGE"],"type":"string"},"funding_impact":{"type":"object"},"risk_disclosure":{"type":"object"},"liquidation_price":{"type":"number"},"survives_calibrated_range":{"type":"boolean"},"max_leverage_surviving_range":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZQB84D-MO4QHL2-96H0WK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates whether a leveraged perpetual futures position will survive the calibrated 80% price range, returning a verdict, liquidation price, max safe leverage, P&L at range bounds, and funding cost over a horizon.","exampleAgentPrompt":"Before I open a 5x long on ETH, check if that position would survive the calibrated 80% price range — use a $10,000 notional and a 24-hour horizon, and tell me the liquidation price, verdict, and max safe leverage.","exampleUseCases":[{"title":"Pre-trade leverage gate for BTC long","prompt":"I'm about to open a 8x long on BTC at current market price — can you run a risk check to see if that position survives the calibrated range, and tell me the verdict plus what the max safe leverage actually is?"},{"title":"Stress test open SOL short position","prompt":"I have an open 4x short on SOL entered at $145 — can you stress test it against the 80% price range and tell me whether it survives, the liquidation price, and what my P&L looks like at both range bounds?"},{"title":"Funding cost estimate for overnight ETH position","prompt":"I'm planning to hold a 3x long on ETH with a $25,000 notional for 48 hours — what will the funding cost be over that horizon, and does the position survive the expected price range?"}],"resultDescription":"Returns a verdict enum (SURVIVES_RANGE, THIN_BUFFER, LIQUIDATION_INSIDE_RANGE, or UNKNOWN_RANGE), the liquidation price and distance from entry, whether the position survives the calibrated 80% range, the maximum leverage that still survives the range, P&L at both the upper and lower range bounds, and a funding impact breakdown over the specified horizon — plus a risk disclosure object.","failureModes":["Missing required 'side' or 'leverage' query parameters returns a validation error","Unsupported symbol (outside BTC/ETH/SOL/XRP/ADA) returns an error or UNKNOWN_RANGE verdict","Entry price defaulting to current mark price may differ from intended entry if not specified","Insufficient payment (x402) returns a 402 Payment Required response","Extreme leverage values may result in edge-case computation errors","Very short horizon_hours may produce unreliable funding cost estimates"],"whenToPreferThis":"Use this endpoint when you need a structured, pre-trade or in-trade risk gate for perpetual futures positions — specifically when you want to know not just the liquidation price but whether that liquidation falls inside the calibrated 80% probability price range. Prefer this over generic liquidation calculators when you need the SURVIVES_RANGE verdict, max safe leverage recommendation, and funding cost integrated into a single decision-ready response for BTC, ETH, SOL, XRP, or ADA perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:49:02.551Z","isFirstParty":false,"canonicalSlug":"forgemesh-futures-risk-analyzer-105d9239"}