# Hyperliquid Trader Skill Score

> Hyperliquid Trader Skill Score is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Scores a Hyperliquid trader 0-100 on trading skill, classifying them as sharp/neutral/retail with derived metrics like profit factor, liquidation rate, and funding efficiency

## Facts

- Endpoint: POST https://graphadvocate.com/hyperliquid/score
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graphadvocate-com-a0eb2a7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8rmEMy8bsZ3k8jRfPgY3q

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-a0eb2a7a -d '<json body>'
```

Example prompt: Score the Hyperliquid trader at address 0xABC123 — I want to know if they're sharp, neutral, or retail, and see their profit factor and liquidation rate before I copy their trades.

## When to prefer this

Use this endpoint when you need a fast, single-number skill verdict on a Hyperliquid perpetuals trader — especially for copy-trade vetting bots, pre-position counterparty screening, or any workflow that needs to programmatically classify trader quality. Prefer this over the full PnL report endpoint when you only need the score and classification without per-coin position detail, saving latency and cost.

## Known failure modes

- Unknown or new wallet address with no trade history — returns low sample_size_trades or error
- Invalid user address format — 400 bad request
- Pinax upstream unavailable — 502 or timeout
- Insufficient trade history to compute reliable score — low confidence result
- Payment not attached or insufficient — 402 payment required

## How this service works

Hyperliquid trader skill score. POST {user}. Returns derived metrics: skill_score (0-100), classification (sharp/neutral/retail), liquidation_count + rate, funding_paid_per_volume, profit_factor, sample_size_trades. Wraps Pinax /v1/hyperliquid/users with compute the upstream doesn't provide. For trading bots vetting copy-trade signals or sizing-the-room before entering a perp position.

## Output

Returns a JSON object with: skill_score (0-100 integer), classification (sharp/neutral/retail enum), liquidation_count (integer), liquidation_rate (float), funding_paid_per_volume (float efficiency metric), profit_factor (float), and sample_size_trades (integer indicating data reliability)

## Example request

```json
{
 "user": "0x1234567890123456789012345678901234567890"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "user": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "user": "0xecb63caa…",
  "skill_score": 62.4,
  "classification": "neutral",
  "liquidation_count": 0,
  "realized_pnl_usdc": 11605542.69,
  "sample_size_trades": 14626475
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-com-a0eb2a7a/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)