# Hyperliquid Market Price Lookup

> Hyperliquid Market Price Lookup 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-15).

Fetches real-time or latest price data for a given Hyperliquid perpetual market asset

## Facts

- Endpoint: POST https://hyperliquid-data.v1337.org/v1/markets/price
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-market-price-lookup-0f6f3912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eCaRO03_J3XTEYEJYCktr

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-market-price-lookup-0f6f3912 -d '<json body>'
```

Example prompt: What's the current price of the BTC perpetual on Hyperliquid right now?

## When to prefer this

Choose this endpoint when you need real-time or latest perpetual market prices sourced directly from Hyperliquid's own data infrastructure without relying on third-party aggregators. Ideal for agents that require first-party Hyperliquid price data for trading decisions, portfolio valuation, or alerting — especially when data integrity and source authenticity from Hyperliquid's own node ledger matter. The pay-per-call x402 model means no API key setup is needed.

## Known failure modes

- Unknown or invalid asset symbol returns an error or empty result
- Payment via x402 on Base fails if wallet has insufficient USDC balance
- Network timeout if Hyperliquid public API is temporarily unavailable
- Malformed POST body (wrong field names or types) returns a 400-level error
- Market not yet listed or delisted asset returns no price data

## 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 the current price (and likely related market data such as mark price, index price, or last trade price) for the specified Hyperliquid perpetual market asset, sourced directly from Hyperliquid's first-party node fills ledger and public info API.

## 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-market-price-lookup-0f6f3912/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)