# Hyperliquid Markets Price Endpoint

> Hyperliquid Markets Price Endpoint is a paid API for AI agents from hyperliquid-data.v1337.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Fetches current market price data for perpetual futures markets on the Hyperliquid DEX, computed from first-party node data.

## Facts

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

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-markets-price-endpoint-ea0595af -d '<json body>'
```

Example prompt: What is the current price of BTC perpetual futures on Hyperliquid right now? Pull it from the Hyperliquid first-party data feed.

## When to prefer this

Use this endpoint when you need real-time or current price data specifically for Hyperliquid perpetual futures markets, computed directly from Hyperliquid's own node data with no third-party intermediary. Prefer this over generic crypto price APIs when accuracy to Hyperliquid's actual trading prices matters, or when you are already working within the Hyperliquid trading intelligence suite for fills, positions, or leaderboard data.

## Known failure modes

- Market symbol not recognized — returns error if the requested asset/pair is not listed on Hyperliquid
- HTTP 402 Payment Required — quota exhausted; must pay 0.001 USDC per call via x402 protocol
- Malformed request body — missing required fields returns validation error
- Upstream Hyperliquid node temporarily unavailable — may return 5xx error
- Invalid body type or method — non-JSON body or wrong HTTP method returns 400

## How this service works

Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).

## Output

Returns current market price data for the specified perpetual futures market on Hyperliquid, derived from first-party node data rather than any third-party source.

## 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-markets-price-endpoint-ea0595af/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)