# Hyperliquid Portfolio Trade Fills Lookup

> Hyperliquid Portfolio Trade Fills Lookup is a paid API for AI agents from klymax402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Retrieves a list of recent trade fills (executed orders) for a given Hyperliquid wallet address

## Facts

- Endpoint: GET https://klymax402.com/api/hl-portfolio/api/fills
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-portfolio-trade-fills-lookup-5079f7c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cFH16JEdDkRAJbPziPB64

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-portfolio-trade-fills-lookup-5079f7c0
```

Example prompt: Show me the last 50 trade fills for my Hyperliquid wallet 0xABCD1234... so I can review what orders got executed recently.

## When to prefer this

Use this endpoint when you need to look up executed trade fills (order completions) for a specific Hyperliquid wallet address, particularly for portfolio review, trading audit, or performance analysis on the Hyperliquid perpetuals DEX. Prefer this over generic blockchain explorers when you need structured fill data specifically from Hyperliquid's trading engine.

## Known failure modes

- Invalid or malformed wallet address returns empty fills array
- Limit value exceeding 100 may be capped or rejected
- Wallet address with no trading history returns count:0 and empty fills array
- Network or upstream Hyperliquid API unavailability causes request failure
- Non-0x formatted address strings may not be recognized

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

Returns a JSON object containing a count of fills returned and an array of fill records for the specified Hyperliquid wallet address. Each fill represents an executed trade order with details about the position, price, size, and timing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Maximum number of fills to return (default: 20, max: 100)"
  },
  "address": {
   "type": "string",
   "description": "Hyperliquid wallet address (0x...) to retrieve trade fills for"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "fills": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-portfolio-trade-fills-lookup-5079f7c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)