# Hyperliquid Account Portfolio History

> Hyperliquid Account Portfolio History is a paid API for AI agents from hyperliquid-accounts.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns historical account value and PnL for a Hyperliquid address across day, week, month, and all-time windows.

## Facts

- Endpoint: GET https://hyperliquid-accounts.use.x402atlas.com/portfolio
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-account-portfolio-history-ada7f1c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NSS94uTweCw9jVwV9a0rO

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-account-portfolio-history-ada7f1c8
```

Example prompt: Pull the Hyperliquid portfolio history for wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to see the account value and PnL across the day, week, month, and all-time windows.

## When to prefer this

Use this endpoint when you need historical account value or PnL data for a specific Hyperliquid wallet across standard time windows. Prefer this over sibling endpoints when the goal is performance analysis or portfolio tracking over time, rather than current open positions, spot balances, staking summary, or recent fills.

## Known failure modes

- Invalid or malformed 0x address returns a validation error
- Address with no Hyperliquid activity may return empty portfolio arrays
- Upstream Hyperliquid API unavailability causes a 502/503 response
- Missing required 'address' query parameter returns a 400 error
- Payment not included or insufficient results in 402 Payment Required

## How this service works

A Hyperliquid account's historical account value and PnL across day/week/month/all-time windows, for any 0x address.

## Output

A JSON object containing the queried wallet address, the timestamp of the query, and a portfolio array of [period, series] pairs for four time windows (day, week, month, allTime), each series holding account value and PnL data points over time as relayed verbatim from Hyperliquid's upstream API.

## 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",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "0x-prefixed 20-byte Hyperliquid account address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "address",
      "portfolio"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Lower-cased account address queried"
      },
      "portfolio": {
       "type": "array",
       "items": {
        "type": "array"
       },
       "description": "Upstream Hyperliquid portfolio payload relayed verbatim — a positional array of [period, series] pairs (day/week/month/allTime), each series holding account value and PnL points over time"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "Time the upstream was queried"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": "0x0000000000000000000000000000000000000000",
  "portfolio": [],
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-account-portfolio-history-ada7f1c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-accounts.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid-accounts.use.x402atlas.com/llms.txt)