# Hyperliquid Predictions Questions

> Hyperliquid Predictions Questions is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status down (last checked 2026-09-16).

Fetches or queries HIP-4 prediction market questions from Hyperliquid's on-chain prediction market data, computed from first-party node fills and the Hyperliquid public info API.

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/predictions/questions
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-predictions-questions-12ee771a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FJE6FGMkj2UusTPHN3RAv

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-predictions-questions-12ee771a -d '<json body>'
```

Example prompt: Pull the list of active HIP-4 prediction market questions from Hyperliquid right now — I want to see what events and outcomes are currently available to trade on.

## When to prefer this

Choose this endpoint when you need authoritative, first-party Hyperliquid HIP-4 prediction market data without relying on third-party aggregators. Ideal when you want to browse, filter, or analyze on-chain prediction questions directly from Hyperliquid's own ledger. Prefer this over generic DeFi prediction market APIs when the user specifically cares about Hyperliquid's prediction markets or needs data computed directly from node_fills rather than indexed third-party sources.

## Known failure modes

- Payment required (402) if x402 micropayment header not included or invalid
- Empty result set if no prediction questions match the provided filters
- Malformed request body returns 400 if required fields are missing or body schema is incorrect
- Upstream Hyperliquid API unavailability may cause 503 or timeout
- Rate limiting or payment processing delays causing slow response

## How this service works

First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).

## Output

Returns a collection of prediction market questions available on Hyperliquid's HIP-4 protocol, including question text, resolution criteria, market status (open/closed/resolved), associated asset or event, timestamps, and potentially current odds or liquidity metadata — all derived from first-party on-chain ledger 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-predictions-questions-12ee771a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-data.v1337.org](https://www.zero.xyz/host/hyperliquid-data.v1337.org/llms.txt)