# Hyperliquid Trader Profile & Live Perp Positions

> Hyperliquid Trader Profile & Live Perp Positions is a paid API for AI agents from api.solenrich.com, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-14).

Returns live perpetual futures positions, risk flags, account value, PnL history, and smart-money profile metrics for a given Hyperliquid EVM address.

## Facts

- Endpoint: POST https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-trader-profile-live-perp-positions-98ff4157
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_13XV-GH9QRtm3ZZQZwuYF

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-profile-live-perp-positions-98ff4157 -d '<json body>'
```

Example prompt: Pull the live perp positions and risk profile for Hyperliquid address 0x1234567890abcdef1234567890abcdef12345678 — I want to see their current leverage, any liquidation warnings, and their PnL over the past week and month.

## When to prefer this

Use this endpoint when you need a complete, real-time risk and performance snapshot of a specific Hyperliquid perpetuals trader — especially for smart-money surveillance, copy-trading due diligence, or liquidation risk monitoring. Prefer this over generic portfolio trackers when you specifically need Hyperliquid perp-level data including risk flags and weighted leverage.

## Known failure modes

- Invalid or malformed 0x address returns a validation error
- Address has no open positions — returns empty positions array with account-level data only
- Hyperliquid on-chain state temporarily unavailable — upstream timeout or data gap
- Address has never traded on Hyperliquid — returns zeroed-out or minimal profile
- Incorrect format enum value causes schema validation failure

## How this service works

Live perp positions for a Hyperliquid EVM (0x) address, read from Hyperliquid's public on-chain state. Per-position coin, side, leverage, notional, entry, unrealized PnL, distance-to-liquidation, and risk flags (high/extreme leverage, approaching liquidation, losing). Plus account value, directional bias, profile, weighted leverage, and realized+unrealized PnL over week/month/all-time. The building block for smart-money tracking.

## Output

A structured breakdown of all open perpetual positions for the address (coin, long/short side, leverage, notional, entry price, unrealized PnL, distance to liquidation, risk flags like high/extreme leverage or approaching liquidation), plus account-level data: total account value, directional bias, weighted leverage, trader profile classification, and realized+unrealized PnL over the past week, month, and all time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "format": {
   "enum": [
    "json",
    "llm",
    "both"
   ],
   "type": "string",
   "default": "json"
  },
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Hyperliquid EVM (0x) address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "output": {
   "briefing": "string (llm format) or object (json format)"
  },
  "run_id": "uuid",
  "status": "succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-trader-profile-live-perp-positions-98ff4157/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solenrich.com](https://www.zero.xyz/host/api.solenrich.com/llms.txt)