# Hyperliquid Spot Market Live Context

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

Returns live price, 24h notional volume, and token supply data for every Hyperliquid spot trading pair with resolved token names.

## Facts

- Endpoint: GET https://hyperliquid.use.x402atlas.com/spot
- 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-spot-market-live-context-e9dd507b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OD0C20LeDxjOfFHHajkGG

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-spot-market-live-context-e9dd507b
```

Example prompt: Pull up the full live snapshot of all Hyperliquid spot pairs — I want each token's mid price, mark price, 24h notional volume, and circulating supply right now.

## When to prefer this

Use this endpoint when you need a comprehensive, single-call snapshot of all Hyperliquid spot market pairs including prices, volumes, and token supply — especially when building dashboards, screening for trading opportunities, or enriching data with resolved token names. Prefer over the whole-venue mid-price endpoint when you also need supply data or 24h volume context.

## Known failure modes

- Hyperliquid API unavailable — upstream data fetch fails
- Payment not included or invalid — 402 Payment Required returned
- Network timeout if Hyperliquid data source is slow
- Empty pairs array if Hyperliquid spot market has no active pairs

## How this service works

Live context for every Hyperliquid spot pair — price, 24h notional volume and token supply, with token names resolved and context zipped in.

## Output

A JSON object containing a count of spot pairs and an array of pair objects, each with name, mid_px, mark_px, base_token, quote_token, day_ntl_vlm, prev_day_px, total_supply, and circulating_supply fields, plus a queried_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "pairs": [
   {
    "name": "PURR/USDC",
    "mid_px": "0.141",
    "mark_px": "0.14",
    "base_token": "PURR",
    "day_ntl_vlm": "12345.6",
    "prev_day_px": "0.13",
    "quote_token": "USDC",
    "total_supply": "1000000000.0",
    "circulating_supply": "1000000000.0"
   }
  ],
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-spot-market-live-context-e9dd507b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid.use.x402atlas.com/llms.txt)