# Hyperliquid Trader Performance Analytics

> Hyperliquid Trader Performance Analytics is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Returns computed performance metrics for Hyperliquid perpetual traders, including PnL, win rates, position lifecycles, and cohort comparisons derived from first-party node fills data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/traders/performance
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-trader-performance-analytics-8ad6c912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5CFioK48B1Wjs0Rw4D-G6

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 hyperliquid-trader-performance-analytics-8ad6c912 -d '<json body>'
```

Example prompt: Pull the trading performance stats for Hyperliquid wallet 0xAbC123... — I want to see their PnL, win rate, and how they rank against similar traders on the leaderboard.

## When to prefer this

Choose this endpoint when you need first-party, node-derived Hyperliquid perpetuals performance data with no third-party intermediary. It is ideal for agents doing copy-trade due diligence, leaderboard monitoring, risk assessment, or cohort analysis on Hyperliquid wallets. Prefer it over generic DeFi analytics APIs when you specifically need Hyperliquid perp fills, position lifecycle granularity, or HIP-4 prediction market context. Requires a $0.001 USDC micropayment per call via x402 on Base — no API key or account needed.

## Known failure modes

- Unknown wallet address returns empty or 404 response
- Malformed request body causes 400 validation error
- Insufficient USDC balance or failed x402 micropayment returns 402 Payment Required
- Rate limiting or node data lag may cause stale or temporarily unavailable metrics
- Invalid time range or unsupported filter parameters return 422 error

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

A JSON object containing computed performance metrics for the queried trader(s), including realized and unrealized PnL, fill counts, win/loss ratios, average position durations, liquidation risk indicators, leaderboard rank, and cohort benchmarks — all derived from first-party Hyperliquid node fills data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-trader-performance-analytics-8ad6c912/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)