# Hyperliquid Prediction Market Settled Outcome Lookup

> Hyperliquid Prediction Market Settled Outcome Lookup is a paid API for AI agents from hyperliquid-predict.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the settled result for a specific Hyperliquid prediction-market outcome by its outcome ID.

## Facts

- Endpoint: GET https://hyperliquid-predict.use.x402atlas.com/settled
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-prediction-market-settled-outcome-lookup-59f091ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ddBe_iLDuOpnOnHehhV2p

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-prediction-market-settled-outcome-lookup-59f091ac
```

Example prompt: Can you check what the settled result was for Hyperliquid prediction market outcome ID 'btc-above-100k-jan2025'?

## When to prefer this

Use this endpoint when you need to look up the definitive settled result for a specific Hyperliquid prediction market outcome by its ID. Prefer this over the catalog endpoint (/outcomes) when you already have an outcome ID and need the resolution/settlement data rather than metadata about available outcomes.

## Known failure modes

- Invalid or unknown outcome ID returns an error or empty result
- Outcome ID exists but has not yet been settled — may return null or pending state
- Upstream Hyperliquid API unavailable causes relay failure
- Missing required 'outcome' query parameter returns 400-level error
- Outcome ID exceeds 128 character limit is rejected

## How this service works

The settled result for one Hyperliquid prediction-market outcome by id.

## Output

Returns a JSON object containing the queried outcome ID, the UTC timestamp when the upstream was queried, and the verbatim settled outcome payload from Hyperliquid including the resolution result of the prediction market outcome.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "outcome"
     ],
     "properties": {
      "outcome": {
       "type": "string",
       "maxLength": 128,
       "description": "Prediction-market outcome id (from /outcomes)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "outcome",
      "result"
     ],
     "properties": {
      "result": {
       "type": "object",
       "description": "Upstream settledOutcome payload for this outcome, relayed verbatim"
      },
      "outcome": {
       "type": "string",
       "description": "The outcome id that was queried"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "UTC timestamp when the upstream was queried"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "outcome": "1",
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-prediction-market-settled-outcome-lookup-59f091ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid-predict.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid-predict.use.x402atlas.com/llms.txt)