{"uid":"cap_x7Wxiqdy-rgFoVQXMyoab","slug":"finmath-perpetual-futures-liquidation-price-calculator-572c41a0","name":"finmath Perpetual Futures Liquidation Price Calculator","description":"Deterministic finance and crypto math for AI agents: TradFi (NPV, IRR, XIRR, Black-Scholes + Greeks, bonds, VaR, Sharpe) and DeFi (impermanent loss, perp liquidation, funding, Uniswap v3, health factor, cost basis). Exact, model-free arithmetic that LLMs get wrong — priced per call in USDC.","url":"https://finmath.qzqh5rrbkz.workers.dev/v1/perp_liquidation_price","method":"POST","headers":{},"bodySchema":{"type":"object","required":["side","leverage","entry_price"],"properties":{"side":{"type":"string","description":"side"},"leverage":{"type":"number","description":"leverage"},"entry_price":{"type":"number","description":"entry_price"},"maintenance_margin_rate":{"type":"number","description":"maintenance_margin_rate"}}},"responseSchema":{"type":"object","required":["result","meta"],"properties":{"meta":{"type":"object"},"result":{}}},"example":{"request":{"side":"long","leverage":10,"entry_price":50000,"maintenance_margin_rate":0.05},"response":{"meta":{"tool":"perp_liquidation_price","model":true,"disclaimer":"Deterministic calculation utility. Not financial, investment, or trading advice.","assumptions":["isolated margin","linear (USDT-margined) contract","excludes fees and funding","single flat maintenance-margin rate (real venues use tiers)"],"deterministic":true},"result":{"assumptions":"isolated margin, linear contract, excludes fees/funding, flat MMR","distance_pct":-0.05,"liquidation_price":47500}}},"exampleRequest":{"side":"long","leverage":10,"entry_price":50000,"maintenance_margin_rate":0.05},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_47P6Qg2NEiStCYYolKLna","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the liquidation price for a perpetual futures (perp) position given side, leverage, entry price, and optional maintenance margin rate","exampleAgentPrompt":"I opened a long perp position on BTC at an entry price of $65,000 with 10x leverage — what's my liquidation price? Use a 0.5% maintenance margin rate.","exampleUseCases":null,"resultDescription":"Returns a result object containing the computed liquidation price for the perpetual futures position, along with a meta object containing calculation details such as the model used and input echo.","failureModes":["Missing required fields (side, leverage, entry_price) returns 400 error","Invalid side value (not 'long' or 'short') causes computation error","Leverage of 0 or negative causes division error","Entry price of 0 or negative is invalid","Maintenance margin rate outside 0-1 range may produce nonsensical result","Payment of 0.002 USDC not provided results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need exact, deterministic liquidation price arithmetic for perpetual futures positions — especially when an LLM's approximation is unacceptable for risk management decisions. Prefer this over manual calculation or LLM estimation when precision matters for trading safety or automated risk alerts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:57.306Z","isFirstParty":false}