# Hyperliquid Wallet Trade History

> Hyperliquid Wallet Trade History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-20).

Fetches the latest trades executed by any wallet on Hyperliquid, returning per-trade details (asset, side, direction, price, size, USD value, realized PnL, fee) plus aggregated totals.

## Facts

- Endpoint: POST https://api.vextorium.com/hyperliquid-operaciones-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-wallet-trade-history-3558b3ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sxft6thTU0iWEyKEpCJM1

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-wallet-trade-history-3558b3ea -d '<json body>'
```

Example prompt: Pull the last 50 trades for Hyperliquid wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and show me each trade's asset, direction, realized PnL, and the overall totals.

## When to prefer this

Use this endpoint when you need structured, per-trade data for a specific Hyperliquid wallet, including realized PnL and fee breakdowns that are difficult to obtain from raw on-chain data. It is ideal for auditing trading bots, tracking whale wallets, or building PnL reports. Prefer it over generic blockchain explorers when you need Hyperliquid-specific trade semantics like open/close direction and pre-computed USD values.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- No trades found for the wallet returns an empty detalle array with zero totals
- Unsupported asset filter returns empty results rather than an error
- limite out of range (below 1 or above 200) may be clamped or cause a validation error
- Hyperliquid API unavailability results in a fetch failure or timeout

## How this service works

Latest trades executed by any wallet on Hyperliquid: asset, side, open/close direction, price, size, USD value, realized PnL and fee, with totals. Track a trader or audit a bot.

## Output

A JSON object containing the wallet address, data source label, a list of individual trades (each with date, asset, buy/sell side, open/close direction, price, size, USD value, realized PnL in USD, and fee), plus aggregate totals for trade count, total volume in USD, total fees, and total realized PnL in USD.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limite": {
   "type": "integer",
   "description": "Trades (1-200, default 30)"
  },
  "moneda": {
   "type": "string",
   "description": "Only this asset (optional)"
  },
  "wallet": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "Hyperliquid (datos abiertos)",
  "wallet": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
  "detalle": [
   {
    "lado": "compra",
    "fecha": "2026-10-02T15:13:44+00:00",
    "activo": "ETH",
    "precio": 2705.5,
    "tamano": 0.1576,
    "comision": 0,
    "direccion": "Open Long",
    "valor_usd": 426.39,
    "pnl_realizado_usd": 0
   },
   {
    "lado": "venta",
    "fecha": "2026-10-02T15:13:44+00:00",
    "activo": "BLUR",
    "precio": 0.021368,
    "tamano": 871,
    "comision": 0,
    "direccion": "Close Long",
    "valor_usd": 18.61,
    "pnl_realizado_usd": -0.266526
   },
   {
    "lado": "compra",
    "fecha": "2026-10-02T15:13:44+00:00",
    "activo": "MELANIA",
    "precio": 0.10768,
    "tamano": 326.5,
    "comision": 0,
    "direccion": "Close Short",
    "valor_usd": 35.16,
    "pnl_realizado_usd": -0.545255
   },
   {
    "lado": "venta",
    "fecha": "2026-10-02T15:13:44+00:00",
    "activo": "ONDO",
    "precio": 0.50772,
    "tamano": 20,
    "comision": 0,
    "direccion": "Close Long",
    "valor_usd": 10.15,
    "pnl_realizado_usd": 0.06116
   },
   {
    "lado": "venta",
    "fecha": "2026-10-02T15:13:43+00:00",
    "activo": "IOTA",
    "precio": 0.054684,
    "tamano": 491,
    "comision": 0,
    "direccion": "Close Long",
    "valor_usd": 26.85,
    "pnl_realizado_usd": 0.01964
   }
  ],
  "operaciones": 5,
  "volumen_usd": 517.16,
  "comisiones_total": 0,
  "pnl_realizado_total_usd": -0.73
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-wallet-trade-history-3558b3ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)