# Hyperliquid Market Room Screener

> Hyperliquid Market Room Screener is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: POST https://graphadvocate.com/hyperliquid/screen
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graphadvocate-com-57feb427
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i0fRvJteJtIxxSpg45J7z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability graphadvocate-com-57feb427 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Example request

```json
{
 "n": 10,
 "coin": "BTC"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1
  },
  "coin": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-com-57feb427/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)