# ChainHilt Hyperliquid Portfolio Report

> ChainHilt Hyperliquid Portfolio Report is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Generates a comprehensive agent-ready portfolio report for a Hyperliquid account, covering equity, PnL, leverage, margin health, liquidation exposure, and concentration risk.

## Facts

- Endpoint: POST https://chainhilt.ai/api/v1/perp/hyperliquid/portfolio/report?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-hyperliquid-portfolio-report-bd2600d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_teSsgncPtOWRuk1NFXz5Z

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 chainhilt-hyperliquid-portfolio-report-bd2600d7 -d '<json body>'
```

Example prompt: Pull a full Hyperliquid portfolio report for address 0xAbC1234567890abcdef1234567890abcdef123456 — I want to see my equity, PnL, leverage, margin health, and liquidation exposure.

## When to prefer this

Use this endpoint when an agent needs a holistic, pre-parsed risk and portfolio summary for a Hyperliquid account without having to manually aggregate raw on-chain data. Prefer this over raw Hyperliquid API calls when you need risk metrics (margin health, liquidation exposure, concentration) already computed and agent-readable. Best suited for trading bots, risk dashboards, or any workflow that needs to gate actions on portfolio health.

## Known failure modes

- 400 Bad Request: invalid or malformed Ethereum address (must match ^0x[a-fA-F0-9]{40}$)
- 502 Bad Gateway: upstream Hyperliquid provider failure or timeout
- Empty or zero-value report if the address has no active positions or account history

## How this service works

Produce an agent-ready Hyperliquid portfolio report covering equity, PnL, leverage, margin health, liquidation exposure, and concentration. Errors: 400 invalid input, 502 provider failure. Treat spot and perp as one balance only when the account abstraction mode is "unifiedAccount".

## Output

Returns a structured JSON portfolio report containing risk level (e.g. 'moderate'), total account value, withdrawable balance, unrealized PnL, leverage metrics, margin health indicators, liquidation exposure, and position concentration data. Optionally includes raw Hyperliquid API payloads if includeRaw is true.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Hyperliquid account address to analyze."
  },
  "includeRaw": {
   "type": "boolean",
   "description": "true to include the raw Hyperliquid payloads in the response."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "report": {
   "riskLevel": "moderate",
   "accountValue": "12500.00",
   "withdrawable": "7400.00"
  }
 }
}
```

## More

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