# Hyperliquid Recent Fill Stream (graphadvocate.com)

> Hyperliquid Recent Fill Stream (graphadvocate.com) is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the last N fills for a Hyperliquid perpetual coin, including per-fill details and an aggregate summary with buy/sell notional split and whale fill count.

## Facts

- Endpoint: POST https://graphadvocate.com/hyperliquid/fills
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graphadvocate-com-2b231a42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5dAG_2VhXLbLGmI32WhEx

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 graphadvocate-com-2b231a42 -d '<json body>'
```

Example prompt: Pull the last 30 fills for ETH on Hyperliquid and tell me how much was bought vs sold, the average price, and whether any whale fills over $10k happened.

## When to prefer this

Use this endpoint when you need recent trade event data for a specific Hyperliquid perpetual — especially for whale-watching, flow-following bots, or detecting buy/sell imbalances in real time. Prefer this over hl-screen (which ranks top traders by lifetime volume) when you want time-stamped fill events and aggregate pressure metrics, not historical trader rankings.

## Known failure modes

- Unknown or unsupported coin symbol returns an error or empty fill list
- n exceeds allowed maximum causing a validation error
- Hyperliquid API unavailability causes upstream timeout or empty response
- Malformed request body (missing coin or n) returns a 400-level error
- Rate limiting or payment failure for the $0.02 USDC per-call fee

## How this service works

Recent fill stream for a Hyperliquid perp coin. POST {coin, n}. Returns the last N fills (direction, side, price, size, notional, fee, trader address) plus an aggregate summary (buy/sell notional split, whale_fill_count for fills ≥ $10k, avg price). Distinct from hl-screen (top traders by lifetime volume) — this is recent trade events as they happen, for whale-watching + flow-following bots.

## Output

Returns a list of the last N fills for the specified Hyperliquid perp coin — each with direction, side, price, size, notional, fee, and trader address — plus an aggregate summary showing buy notional, sell notional, whale fill count (fills ≥ $10k), and average price.

## Example request

```json
{
 "n": 30,
 "coin": "ETH"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 1
  },
  "coin": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "fills": [
   {
    "fee": 0.048,
    "side": "ASK",
    "size": 0.00084,
    "user": "0x1738e6cb…",
    "price": 73430,
    "notional": 61.68,
    "direction": "OPEN_SHORT",
    "timestamp": "2026-05-28 17:22:28"
   }
  ],
  "summary": {
   "buy_count": 4,
   "sell_count": 6,
   "unique_users": 8,
   "notional_usdc": 2342.15,
   "whale_fill_count": 0
  },
  "fill_count": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-com-2b231a42/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)