# Vextorium Hyperliquid Trades

> Vextorium Hyperliquid Trades 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-11).

Retrieves recent trade history for a Hyperliquid wallet address, including per-trade details, fees, volume, and realized PnL.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-trades?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-trades-9b650d5a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U9RHidsNxTMBILCMNBjSM

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 vextorium-hyperliquid-trades-9b650d5a -d '<json body>'
```

Example prompt: Pull the last 50 Hyperliquid trades for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and give me the total volume, total fees, and realized PnL — filter to ETH trades only.

## When to prefer this

Use this endpoint when you need granular, per-trade Hyperliquid perpetuals history for a specific wallet — including realized PnL, fees, and asset breakdown. Prefer it over generic DeFi endpoints when the user's question is specifically about Hyperliquid trading activity, or when you need realized PnL data that on-chain DEX aggregators don't provide for perpetuals.

## Known failure modes

- Invalid or unrecognized wallet address returns an error or empty result
- Limit outside 1-200 range may be rejected or clamped
- Currency filter that matches no trades returns an empty detail array
- Network or Hyperliquid data availability issues may cause timeouts
- Payment failure (insufficient USDC balance) blocks the request

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

Returns a JSON object with a list of up to 200 individual trades (each with date, side, asset, price, size, USD value, fee, realized PnL, and position label), plus aggregate stats: total trade count, total volume in USD, total fees paid, and total realized PnL in USD. Also includes the source attribution and wallet address echo.

## 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": {
     "required": [
      "wallet"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Trades (1-200, default 30)"
      },
      "wallet": {
       "type": "string"
      },
      "currency": {
       "type": "string",
       "description": "Only this asset (optional)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "detail": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "fee": {
          "type": [
           "null",
           "number"
          ]
         },
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "side": {
          "type": [
           "null",
           "string"
          ]
         },
         "size": {
          "type": [
           "null",
           "number"
          ]
         },
         "asset": {
          "type": [
           "null",
           "string"
          ]
         },
         "price": {
          "type": [
           "null",
           "number"
          ]
         },
         "address": {
          "type": [
           "null",
           "string"
          ]
         },
         "value_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "realized_pnl_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "trades": {
       "type": [
        "number",
        "null"
       ]
      },
      "wallet": {
       "type": [
        "stri
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "detail": [
   {
    "fee": 0,
    "date": "2026-10-02T15:13:44+00:00",
    "side": "buy",
    "size": 0.1576,
    "asset": "ETH",
    "price": 2705.5,
    "address": "Open Long",
    "value_usd": 426.39,
    "realized_pnl_usd": 0
   },
   {
    "fee": 0,
    "date": "2026-10-02T15:13:44+00:00",
    "side": "sell",
    "size": 871,
    "asset": "BLUR",
    "price": 0.021368,
    "address": "Close Long",
    "value_usd": 18.61,
    "realized_pnl_usd": -0.266526
   }
  ],
  "source": "Hyperliquid (open data)",
  "trades": 5,
  "wallet": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
  "total_fees": 0,
  "volume_usd": 517.16,
  "total_realized_pnl_usd": -0.73
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-trades-9b650d5a/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)