{"uid":"cap_cs7-JHZyCHQyIYVWcL65t","slug":"hypernatt-liquidity-radar-liq-radar-ae16ccf2","name":"HYPERNATT Liquidity Radar (liq-radar)","description":"Forced-order map. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is high-leverage bait - ignore. class=true (~7%+) is the low-leverage stack. Terrain, not a signal. Whitelist BTC ETH SOL BNB XRP HYPE ZEC (omit = BTC).","url":"https://hypernatt.com/api/m2m/liq-radar","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true,"symbol":"BTC","product":"hypernatt_liq_radar_v1","liq_radar":{"magnet":{"bias":"BEARISH_MAGNET","score":-60},"ls_ratio":{"long_pct":67,"short_pct":33},"liq_density":{"asymmetry":0.32,"clusters_above":[{"price":64100,"size_btc":60.8,"distance_pct":3.45}],"clusters_below":[{"price":59100,"size_btc":123.5,"distance_pct":4.62}]},"real_liquidations":{"window_1h":{"count":43,"dominant":"short"}}},"default_symbol":"BTC","payload_schema":"hypernatt_liq_radar_v2","supported_symbols":["BTC","ETH","SOL","BNB","XRP","HYPE","ZEC"]}},"example":{"request":{"properties":"BTC"},"response":{"ok":true,"symbol":"BTC","product":"hypernatt_liq_radar_v1","issued_at":"2026-06-17T21:46:25.279Z","liq_radar":{"oi":{"current":99470,"building":false,"delta_48h":-3945,"delta_48h_pct":-3.81,"new_positions_btc":2876},"taker":{"ratio":0.9789,"buy_vol_24h":94893,"sell_vol_24h":96942,"buyers_aggressive":false,"sellers_aggressive":false},"hl_btc":{"oi_btc":30676,"mark_price":64281,"funding_rate":-0.0001},"magnet":{"bias":"BEARISH_MAGNET","score":-45,"signals":["longs_dominant_63pct","longs_paying_funding","liq_asym_long_heavy_+0.288"]},"ls_ratio":{"ratio":1.703,"long_pct":63,"short_pct":37,"trend_24h":4.2,"longs_dominant":true,"shorts_dominant":false},"available":true,"liq_density":{"asymmetry":0.2879,"clusters_above":[{"rank":1,"price":70300,"size_btc":59.4,"distance_pct":9.49},{"rank":2,"price":69600,"size_btc":29.7,"distance_pct":8.4},{"rank":3,"price":67100,"size_btc":29.6,"distance_pct":4.51},{"rank":4,"price":65200,"size_btc":21.4,"distance_pct":1.55},{"rank":5,"price":66500,"size_btc":19.7,"distance_pct":3.57}],"clusters_below":[{"rank":1,"price":58000,"size_btc":101.2,"distance_pct":9.67},{"rank":2,"price":58600,"size_btc":50.6,"distance_pct":8.73},{"rank":3,"price":61200,"size_btc":50.5,"distance_pct":4.68},{"rank":4,"price":61800,"size_btc":50.5,"distance_pct":3.75},{"rank":5,"price":63100,"size_btc":36.4,"distance_pct":1.72}],"long_liq_below_btc":289.1,"short_liq_above_btc":159.9,"nearest_long_cluster":{"rank":1,"price":58000,"size_btc":101.2,"distance_pct":9.67},"nearest_short_cluster":{"rank":1,"price":70300,"size_btc":59.4,"distance_pct":9.49}},"top_traders":{"ratio":1.175,"long_pct":54,"short_pct":46},"funding_history":{"periods":30,"cumulative_pct":-0.0022,"negative_count":12,"positive_count":18,"latest_rate_pct":-0.0026,"shorts_paying_dominant":false},"price_at_compute":64206.01,"real_liquidations":{"age_sec":68,"enabled":true,"available":true,"connected":true,"window_1h":{"count":3,"net_btc":0.038,"dominant":"long","long_liq_btc":0.038,"long_liq_usd":2427,"short_liq_btc":0,"short_liq_usd":0},"window_24h":{"count":1703,"net_btc":185.308,"dominant":"long","long_liq_btc":242.505,"long_liq_usd":15626220,"short_liq_btc":57.197,"short_liq_usd":3785208},"largest_24h":{"usd":2260267,"side":"long","price":64179.3,"qty_btc":35.218},"last_event_ts":1781732715.8,"recent_clusters_1h":[{"side":"long","count":3,"price":63800,"size_btc":0.038}]}}}},"exampleRequest":{"properties":"BTC"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mq_cYlD2HpIFrxYTyg8Lx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time crypto liquidity cluster analysis including magnet bias, long/short ratio, liquidation density, and recent liquidation events for a given symbol.","exampleAgentPrompt":"Pull the HYPERNATT liq-radar for BTC — I want to see whether there's a bullish or bearish magnet right now, where the biggest liquidation clusters are above and below price, and what the long/short ratio looks like.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: magnet bias label (e.g. BEARISH_MAGNET) and numeric score, long/short percentage split, liquidity density asymmetry score, arrays of liquidation clusters above and below current price (each with price level, size in base currency, and distance %), and recent liquidation counts with dominant side over the past 1-hour window.","failureModes":["Unsupported or invalid symbol returns an error or empty result","Network timeout if market data feed is temporarily unavailable","Payment failure if x402 USDC micropayment is not completed (0.001 USDC required per call)","Rate limiting if too many requests are made in a short window","Stale data if underlying exchange feed lags"],"whenToPreferThis":"Use this endpoint when you need real-time crypto liquidation cluster intelligence — specifically magnet bias direction, long/short ratio, and mapped liquidation density zones — for trading decisions or automated signals. Prefer over generic order book endpoints when you specifically want liquidation heatmap and magnet scoring rather than raw order book depth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:08.948Z","isFirstParty":false}