{"uid":"cap_c28PhDi6UHnnBNafZaABT","slug":"ghost77-hyperliquid-liquidation-map-4970e476","name":"GhOsT77 Hyperliquid Liquidation Map","description":"GhOsT77: read-only crypto data jobs for agents and builders: Hyperliquid funding, movers, smart money and liquidation estimates, wallet watch, token unlock calendar, gas timing, rug/honeypot and contract risk screens, cross-venue funding gaps, DeFi protocol stats, Base network health, bridge routes and research. Pay per call in USDC on Base via x402; no account or API key. Automated public data; not financial advice. Also on Virtuals ACP: Agent Task Solver ($5.50), code review and debugging ($1.10), private encrypted code repos for agents ($0.28), a plugin finder ($0.55) and a 30-day daily market bundle with a pull link ($5.50). Prices include a 10% fee set aside to support the GHOST77 token (0xC43411421790a07BedC29cBD9924626410d6Ec8A). Verified identity: ERC-8004 agent #348263 on Base (https://8004scan.io/agents/base/348263) and Virtuals ACP agent GhOsT77 (https://app.virtuals.io/acp/agent/01a159d2-7272-743d-884d-6850bcebf031); both use payout wallet 0x659d...88e3, the same payTo as this endpoint.","url":"https://ghost77-agent.onrender.com/x402/hl_liquidation_map?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asset":{"type":"string","maxLength":20,"minLength":1,"description":"Hyperliquid perp symbol, e.g. BTC, ETH, SOL."},"rangePct":{"type":"number","maximum":50,"minimum":2,"description":"Range around mark in % (default 20)."},"bucketPct":{"type":"number","maximum":5,"minimum":0.25,"description":"Bucket width in % of price (default 1)."}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"coin":{"type":"string"},"markPx":{"type":"number"},"method":{"type":"string"},"buckets":{"type":"array"},"sources":{"type":"array"},"summary":{"type":"string"},"disclaimer":{"type":"string"},"isEstimate":{"type":"boolean"},"estimateNote":{"type":"string"},"largestClusters":{"type":"array"},"longLiqBelowUsd":{"type":"number"},"shortLiqAboveUsd":{"type":"number"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.1","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":"$1.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zow2eF2bT0Xfnk1IrBVse","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns estimated liquidation clusters for a Hyperliquid perpetual asset within a price range, bucketed by percentage intervals, with long/short liquidation totals in USD.","exampleAgentPrompt":"Give me the Hyperliquid liquidation map for ETH using a 20% range around the mark price with 1% buckets — I want to see where the biggest long and short clusters are.","exampleUseCases":[{"title":"Pre-trade liquidation zone check","prompt":"Before I open a short on BTC perps, show me the Hyperliquid liquidation map for BTC with a 15% range and 0.5% buckets so I can see where long liquidations are clustered."},{"title":"Identifying short squeeze levels","prompt":"Where are the biggest short liquidation clusters above the current SOL mark price on Hyperliquid? Use a 25% range and 1% buckets."},{"title":"Liquidation cascade risk assessment","prompt":"I want to know how much USD in long positions would get liquidated if ETH drops in a 20% range — pull the Hyperliquid liquidation map with 2% buckets and summarize the largest clusters."}],"resultDescription":"A JSON object containing the coin symbol, current mark price, an array of bucketed liquidation estimates across the requested price range, the largest liquidation clusters, total USD of long liquidations below mark price, total USD of short liquidations above mark price, a summary string, an estimate note, and a disclaimer indicating these are estimates rather than official data.","failureModes":["Invalid or unsupported Hyperliquid perp symbol returns an error","rangePct outside 2-50 or bucketPct outside 0.25-5 returns a validation error","Hyperliquid data source temporarily unavailable causes fetch failure","Payment via x402/USDC on Base fails if wallet has insufficient balance or misconfigured","Response may be stale if Hyperliquid mark price data is delayed"],"whenToPreferThis":"Use this endpoint when you need to estimate liquidation heatmaps specifically for Hyperliquid perpetual markets and want bucketed price-level analysis of where long and short positions would be forced to close. Prefer this over generic liquidation tools when working with Hyperliquid-native data and needing structured cluster output with USD totals for quantitative analysis or trading strategy research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:53:33.170Z","isFirstParty":false,"canonicalSlug":"ghost77-hyperliquid-liquidation-map-4970e476"}