# Hyperliquid Perpetual Trading History

> Hyperliquid Perpetual Trading History is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.001000/call, status unknown (last checked 2026-09-15).

Retrieves fills, funding payments, and realized PnL history for a given wallet address on Hyperliquid perpetuals.

## Facts

- Endpoint: GET https://x402.ottoai.services/hl-transaction-history
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-ottoai-services-3f9cf2c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xDI5Wy3sdmoInmocHaz8f

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 x402-ottoai-services-3f9cf2c9
```

Example prompt: Pull up the full Hyperliquid perpetuals trading history for wallet 0xAbC123...def — I want to see all my fills, funding payments, and realized PnL per position.

## When to prefer this

Use this endpoint when you need historical perpetuals trading data for a specific Hyperliquid wallet, including fills, funding payments, and realized PnL. Prefer this over general portfolio endpoints when the user specifically wants perp trading activity rather than current balances. Ideal for performance analysis, tax reporting, or auditing trading history on Hyperliquid.

## Known failure modes

- Missing or invalid wallet address returns an error
- Wallet address with no Hyperliquid activity returns an empty history array
- Malformed EVM address format causes a validation error
- Payment not included or insufficient USDC results in a 402 response
- Hyperliquid API downtime may cause delayed or failed responses

## How this service works

Hyperliquid perpetual trading history: fills, funding payments, and realized PnL per position.

## Output

Returns an array of historical trading events for the given wallet on Hyperliquid, including trade fills (entry/exit executions), funding payments received or paid, and realized profit and loss broken down per position.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "EVM wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "status": {
       "type": "string"
      },
      "history": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-ottoai-services-3f9cf2c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ottoai.services](https://www.zero.xyz/host/x402.ottoai.services/llms.txt)