# Hyperliquid Trader Token Holdings Lookup

> Hyperliquid Trader Token Holdings Lookup 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 the token holdings or token-level trading data for traders on Hyperliquid, derived from first-party node fills and position data.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/traders/tokens
- 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-token-holdings-lookup-9d6d1333
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_68BhxfmUNeQM4-8LZSClP

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-token-holdings-lookup-9d6d1333 -d '<json body>'
```

Example prompt: Show me which tokens the top Hyperliquid perp traders are holding or actively trading — I want to see a breakdown of token exposure across the leaderboard wallets.

## When to prefer this

Choose this endpoint when you need first-party, node-sourced Hyperliquid trader token data without relying on third-party aggregators. It is ideal for investigating which tokens specific wallets trade, comparing token exposure across trader cohorts, or building analytics on Hyperliquid perp token activity. Prefer it over generic CEX or multi-chain analytics APIs when the focus is specifically on Hyperliquid perpetuals.

## Known failure modes

- Invalid or missing body payload returns 400 bad request
- Wallet address not found in fill ledger returns empty result set
- Payment not received or x402 handshake failure blocks the request
- Malformed token symbol causes no matching results
- Rate limiting or node sync lag may cause stale or delayed data

## 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 data mapping traders to their token-level activity on Hyperliquid, including positions, fill counts, volume, or holdings per token — sourced from first-party node fill ledger 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-token-holdings-lookup-9d6d1333/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)