# Pa1m Hyperliquid Portfolio Endpoint

> Pa1m Hyperliquid Portfolio Endpoint is a paid API for AI agents from hyperliquid.hypa1m.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Fetches real-time perpetuals portfolio data (open positions and margin summary) for a given Hyperliquid wallet address.

## Facts

- Endpoint: GET https://hyperliquid.hypa1m.xyz/portfolio/%7Baddress%7D
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pa1m-hyperliquid-portfolio-endpoint-ed74d45d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HJzByvcBuEVYaqWHxHhkf

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 pa1m-hyperliquid-portfolio-endpoint-ed74d45d
```

Example prompt: What are the current open perpetuals positions and margin summary for Hyperliquid address 0xAbC123...def456?

## When to prefer this

Use this endpoint when you need real-time perpetuals portfolio data for a specific Hyperliquid wallet address, including open positions and margin summary. Prefer this over generic blockchain explorers when you specifically need Hyperliquid perp position data rather than spot balances or transaction history.

## Known failure modes

- Invalid or malformed wallet address returns empty positions and margin summary
- Non-existent address returns empty data rather than an error
- Network or upstream Hyperliquid API downtime may cause 5xx errors
- Rate limiting may occur for excessive requests without proper payment
- Payment of 0.003 USDC required per call via x402 protocol; failure to pay results in 402 response

## How this service works

Real-time Hyperliquid perpetuals data for AI agents.

## Output

Returns a JSON object containing an array of open perpetual positions and a margin summary object for the queried Hyperliquid wallet address. Positions may be empty if the address has none open; margin summary reflects account-level collateral and equity data.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "EVM wallet address, 0x..."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "positions": [],
  "marginSummary": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pa1m-hyperliquid-portfolio-endpoint-ed74d45d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid.hypa1m.xyz](https://www.zero.xyz/host/hyperliquid.hypa1m.xyz/llms.txt)