# Hyperliquid Copy-Trade Intelligence

> Hyperliquid Copy-Trade Intelligence 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 copy-trade analytics for Hyperliquid perpetuals — identifying top trader wallets, their fill history, position lifecycles, and cohort behavior to support copy-trading strategies.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/copy-trade
- 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-copy-trade-intelligence-82b1573f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uPhG8MHlDBLWnYvubcXM2

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-copy-trade-intelligence-82b1573f -d '<json body>'
```

Example prompt: Pull the copy-trade analysis from Hyperliquid-data for the top performing wallets on Hyperliquid perps over the last 30 days — I want to see their fill history, position lifecycles, and PnL so I can figure out who's worth mirroring.

## When to prefer this

Choose this endpoint when you need first-party Hyperliquid copy-trade intelligence computed directly from the operator's own node_fills ledger — not a third-party aggregator. It is ideal for agents building copy-trading strategies, evaluating specific trader wallets, or ranking cohorts on Hyperliquid perpetual markets. Prefer it over generic DeFi analytics APIs when you specifically need Hyperliquid perp fill history, position lifecycle data, or trader leaderboard signals with pay-per-call pricing and no account setup.

## Known failure modes

- Invalid or malformed request body returns 400 with error detail
- Missing required body fields cause validation failure
- Payment not received or insufficient USDC triggers 402 Payment Required
- Upstream Hyperliquid node unavailable causes 503 or timeout
- Unknown wallet address may return empty results rather than an error
- Rate limiting or quota issues may return 429

## 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

Returns structured copy-trade intelligence including top-trader wallet profiles, perpetual fill records, position lifecycle events, cohort rankings, and PnL metrics — all derived from the operator's own node_fills ledger and the Hyperliquid public info API. Response is JSON with no guaranteed fixed schema beyond what the operator's /openapi.json specifies.

## 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-copy-trade-intelligence-82b1573f/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)