{"uid":"cap_i0fRvJteJtIxxSpg45J7z","slug":"graphadvocate-com-57feb427","name":"Hyperliquid Market Room Screener","description":"Size-the-room for a Hyperliquid market. POST {coin, n?}. Returns the top N (default 10, max 10) traders on a coin ranked by volume, each with skill_score + classification + liquidation_count. Pre-trade check for MM agents: 'who am I about to be against on this perp, and have they been liquidated before?' Coin format: BTC, @107 (spot), xyz:SILVER.","url":"https://graphadvocate.com/hyperliquid/screen","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"n":{"type":"integer","default":10,"maximum":25,"minimum":1},"coin":{"type":"string"}}},"responseSchema":{"type":"json","example":{"coin":"BTC","traders":[{"rank":1,"user":"0x…","skill_score":78.1}],"sharp_count":2,"retail_count":3,"neutral_count":5,"traders_screened":10}},"example":{"request":{"n":10,"coin":"BTC"},"response":{"coin":"BTC","traders":[{"rank":1,"user":"0xc6ac58a7a63339898aeda32499a8238a46d88e84","skill_score":51,"classification":"neutral","coin_volume_usdc":29056367825.363304,"liquidation_count":0,"sample_size_trades":1076324,"coin_realized_pnl_usdc":5069957.974244979},{"rank":2,"user":"0x0fd468a73084daa6ea77a9261e40fdec3e67e0c7","skill_score":50.6,"classification":"neutral","coin_volume_usdc":17106999347.650373,"liquidation_count":0,"sample_size_trades":1689093,"coin_realized_pnl_usdc":1823030.4737719796},{"rank":3,"user":"0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00","skill_score":50.8,"classification":"neutral","coin_volume_usdc":16599477889.573877,"liquidation_count":0,"sample_size_trades":18988368,"coin_realized_pnl_usdc":7613940.084629091},{"rank":4,"user":"0x09bc1cf4d9f0b59e1425a8fde4d4b1f7d3c9410d","skill_score":53,"classification":"neutral","coin_volume_usdc":15160520952.575287,"liquidation_count":0,"sample_size_trades":428018,"coin_realized_pnl_usdc":3671574.4504170017},{"rank":5,"user":"0x7b7f72a28fe109fa703eeed7984f2a8a68fedee2","skill_score":50.4,"classification":"neutral","coin_volume_usdc":14733629217.437498,"liquidation_count":0,"sample_size_trades":3665444,"coin_realized_pnl_usdc":1142264.0471979969},{"rank":6,"user":"0x7ca165f354e3260e2f8d5a7508cc9dd2fa009235","skill_score":52,"classification":"neutral","coin_volume_usdc":10038554794.621735,"liquidation_count":0,"sample_size_trades":415379,"coin_realized_pnl_usdc":2683230.422236046},{"rank":7,"user":"0xf9109ada2f73c62e9889b45453065f0d99260a2d","skill_score":50,"classification":"neutral","coin_volume_usdc":7983136246.293369,"liquidation_count":0,"sample_size_trades":4661251,"coin_realized_pnl_usdc":44049.63611600132},{"rank":8,"user":"0x4bcc092a156905788bf2a1a59e5968623957210d","skill_score":50.7,"classification":"neutral","coin_volume_usdc":7446881679.106992,"liquidation_count":0,"sample_size_trades":143040,"coin_realized_pnl_usdc":822594.7738209992},{"rank":9,"user":"0x8fcc8f55d7a8cdaee770a9e4112725d4a2c60492","skill_score":49.9,"classification":"neutral","coin_volume_usdc":7283096006.0746975,"liquidation_count":0,"sample_size_trades":562874,"coin_realized_pnl_usdc":-250923.8802900003},{"rank":10,"user":"0xf5d81a135f756ca16544e53c20fc20643ec3ad53","skill_score":50.4,"classification":"neutral","coin_volume_usdc":6207197847.51929,"liquidation_count":0,"sample_size_trades":13929014,"coin_realized_pnl_usdc":203599.18043300178}],"sharp_count":0,"generated_at":"2026-05-30T00:20:26.476655+00:00","retail_count":0,"neutral_count":10,"traders_screened":10,"insufficient_data_count":0}},"exampleRequest":{"n":10,"coin":"BTC"},"tags":["x402"],"displayCostAmount":"0.05","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.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_tolVnPt91BzNgau15Q0Ox","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":"Returns the top N traders on a Hyperliquid perpetuals or spot market ranked by volume, with skill scores, trader classifications, and liquidation counts for pre-trade counterparty analysis.","exampleAgentPrompt":"Before I put on a big BTC perp position on Hyperliquid, show me the top 15 traders in that market — I want their skill scores, classifications, and how many times each has been liquidated.","exampleUseCases":null,"resultDescription":"A ranked list of the top N traders (default 10, max 25) on the specified Hyperliquid coin market, each entry containing the trader's address, trading volume rank, skill_score (0-100), trader classification label, and liquidation_count. Useful for assessing the quality and riskiness of counterparties before entering a trade.","failureModes":["Invalid coin format — must use BTC, @107 (spot token ID), or xyz:SILVER format","n exceeds maximum of 25 — clamp to 25","Coin not found on Hyperliquid — returns empty or error response","Payment failure — x402 micropayment not processed, endpoint returns 402","Hyperliquid data unavailable or stale — may return partial results"],"whenToPreferThis":"Use this endpoint when you need a quick pre-trade 'room sizing' check on a specific Hyperliquid perpetual or spot market — especially for market-making agents that need to know the skill level and liquidation history of the dominant volume traders before entering. Prefer over single-trader lookup endpoints when you want a full market-level picture of who controls volume.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:39.948Z","isFirstParty":false}