# Laevitas Hyperliquid Prediction Market Fills

> Laevitas Hyperliquid Prediction Market Fills is a paid API for AI agents from apiv2.laevitas.ch, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Retrieves fill/trade history for prediction markets on Hyperliquid's HyperCore node, with filtering by wallet, instrument, notional size, and time range.

## Facts

- Endpoint: GET https://apiv2.laevitas.ch/api/v1/hyperliquid/node/prediction-fills
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/laevitas-hyperliquid-prediction-market-fills-69cfe676
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4GwcRL6j3m6YrDo_SGgIr

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 laevitas-hyperliquid-prediction-market-fills-69cfe676
```

Example prompt: Pull me the last 100 Hyperliquid prediction market fills for wallet 0xAbC123... sorted by total notional, only include trades with at least $500 notional, from January 1 2025 to January 31 2025.

## When to prefer this

Use this endpoint when you specifically need prediction market fill/trade data from the Hyperliquid HyperCore node. Prefer this over general Hyperliquid perpetuals or spot fills endpoints when the market_type is 'prediction'. Ideal for wallets analytics, trader profiling, and prediction market activity monitoring on Hyperliquid.

## Known failure modes

- Invalid wallet address format returns empty data or error
- Start/end time out of range returns empty data array
- Limit exceeding 1000 returns validation error
- Invalid instrument_name returns empty results
- Missing or invalid API key returns 401 unauthorized
- x402 payment failure returns 402 Payment Required
- Invalid sort_by enum value returns 400 bad request
- Invalid market_type enum value returns 400 bad request

## How this service works

Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.

## Authentication

Use an API key for authenticated REST requests:

```http
X-API-Key: your-api-key-here
```

Most data endpoints also support x402 pay-per-request without an API key.

| Resource | Path |
| --- | --- |
| OpenAPI JSON | `GET /openapi.json` |
| x402 discovery | `GET /.well-known/x402` |
| Changelog | `GET /api/v1/changelog` |
| WebSocket docs | `GET /websocket` |

## REST Surfaces

| Surface | Examples |
| --- | --- |
| Instruments | Cross-market contract reference data |
| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |
| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |
| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |
| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |
| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |
| Predictions | Polymarket instruments, categories, trades, ticker history |
| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |
| Analytics | Realized volatility and derived metrics |

## Pagination

Paginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.

## WebSocket Streaming

Real-time streams are documented at `/websocket`.

| Data | Channel pattern |
| --- | --- |
| Trades | `trades.{market}.{exchange}.{instrument}` |
| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |
| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |

Variables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.

## Quick Start

```bash
curl "https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL" \
  -H "X-API-Key: your-api-key-here"
```

## Output

Returns a JSON object with a 'data' array of prediction market fill records from the Hyperliquid HyperCore node, including trade details such as notional values, realized PnL, and trade counts, plus a 'success' boolean status flag. Supports pagination via cursor.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1
      },
      "start": {
       "type": "string"
      },
      "cursor": {
       "type": "string"
      },
      "dedupe": {
       "type": "boolean"
      },
      "wallet": {
       "type": "string"
      },
      "sort_by": {
       "enum": [
        "time",
        "total_notional",
        "buy_notional",
        "sell_notional",
        "net_notional",
        "realized_pnl",
        "trade_count"
       ],
       "type": "string"
      },
      "currency": {
       "type": "string"
      },
      "exchange": {
       "type": "string"
      },
      "resolution": {
       "enum": [
        "1m",
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
       ],
       "type": "string"
      },
      "market_type": {
       "enum": [
        "perp",
        "perp_hip3",
        "spot",
        "prediction"
       ],
       "type": "string"
      },
      "min_notional": {
       "type": "number"
      },
      "instrument_name": {
       "type": "string"
      },
      "instrument_name_raw": {
       "type": "string"
      },
      "min_target_notional": {
       "type": "number"
      },
      "max_distance_from_mark": {
       "type": "number"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/laevitas-hyperliquid-prediction-market-fills-69cfe676/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiv2.laevitas.ch](https://www.zero.xyz/host/apiv2.laevitas.ch/llms.txt)