# Hyperliquid Counterparty Risk Scorer

> Hyperliquid Counterparty Risk Scorer is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a risk assessment (low/medium/high) for a Hyperliquid trader address, including liquidation history, leverage signals, and recent collateral outflow flags.

## Facts

- Endpoint: POST https://graphadvocate.com/hyperliquid/risk
- Price: $0.02/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-ae2d0446
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u_zKLf12A3xbluoNy2o4s

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

Example prompt: What's the counterparty risk level for Hyperliquid user 0xABCDEF1234567890 — I need to know their risk_level, how many times they've been liquidated, and whether they've drained collateral in the last 24 hours before I consider copying their trades.

## When to prefer this

Use this endpoint when you need a quick, structured risk classification of a specific Hyperliquid counterparty before executing a trade, setting up copy-trading, or pricing adverse selection in a market-making strategy. Prefer this over the full PnL report when you only need risk signals rather than full skill metrics or position breakdowns.

## Known failure modes

- Unknown or new Hyperliquid address with no trading history — may return insufficient data or low-confidence scores
- Invalid address format — returns a validation error
- Hyperliquid API downtime causing stale or unavailable on-chain data
- Rate limiting or payment failure resulting in 402 or 429 response

## How this service works

Hyperliquid counterparty risk. POST {user}. Returns risk_level (low/medium/high), liquidation_count + rate, funding_paid_per_volume (consistent leverage signal), and a recent_24h_outflow_flag (drained collateral). For MM/copy-trade agents pricing adverse selection.

## Output

A JSON object containing: risk_level (low/medium/high), liquidation_count (total liquidations), liquidation_rate (frequency metric), funding_paid_per_volume (consistent leverage usage signal), and recent_24h_outflow_flag (boolean indicating whether collateral was drained in the past 24 hours).

## Example request

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

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "user": "0xecb63caa…",
  "risk_level": "low",
  "skill_score": 62.4,
  "liquidation_count": 0,
  "recent_24h_outflow_flag": false,
  "funding_paid_per_volume_bps": -0.33
 }
}
```

## More

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