# Hyperliquid Spot Market Data by Token Symbol

> Hyperliquid Spot Market Data by Token Symbol is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-10).

Returns live on-chain spot market data for a Hyperliquid-listed token including mid/mark price, 24h volume, supply, and market cap in USDC

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/spot/{token}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-spot-market-data-by-token-symbol-c9b1a195
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6o28Q6sWmskQtL2qagQ8d

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 agents-x402stock-xyz-hyperliquid-spot-market-data-by-token-symbol-c9b1a195
```

Example prompt: What's the current spot price and 24-hour trading volume for HYPE on Hyperliquid, and what's its market cap right now?

## When to prefer this

Use this endpoint when you need live on-chain spot market data specifically for tokens listed on Hyperliquid DEX, including niche or community tokens like PURR and HYPE. Prefer this over /api/v1/crypto for Hyperliquid-native tokens and over /api/v1/perps for spot (not perpetual) price data. Ideal for agents monitoring DeFi token prices, supply metrics, or market cap in real time without needing an API key.

## Known failure modes

- Unknown or unsupported token symbol returns an error — only Hyperliquid-listed spot tokens are valid
- Requesting a perpetuals contract symbol instead of a spot token will fail — use /api/v1/perps/{coin} for perps
- Requesting a major coin like BTC or ETH that is not listed on Hyperliquid spot may return no data — use /api/v1/crypto for those
- Payment failure via x402/USDC will block the response
- Null values for fields like mid_price or market_cap may be returned if the token has no recent activity

## How this service works

Live on-chain spot market for one Hyperliquid-listed token by symbol (e.g. HYPE, PURR) or @index: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap, quoted in USDC. Spot, not a perp — for funding/open interest use /api/v1/perps/{coin}; for major-coin fiat prices use /api/v1/crypto. From x402stock, a market & economic data API (x402, USDC).

## Output

A JSON object containing the token pair identifier, base and quote token names, canonical flag, live mid price, mark price, previous day closing price, 24-hour volume in USD and in base token units, circulating and total supply, and market cap in USDC, along with the data source, venue, market type (spot), and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token"
 ],
 "properties": {
  "token": {
   "type": "string",
   "description": "Hyperliquid spot token symbol, e.g. PURR."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "market",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "pair",
    "id",
    "base_token",
    "quote_token",
    "canonical",
    "mark_price",
    "mid_price",
    "prev_day_price",
    "day_volume_usd",
    "day_volume_base",
    "circulating_supply",
    "total_supply",
    "market_cap_usd"
   ],
   "properties": {
    "id": {
     "type": "string"
    },
    "pair": {
     "type": "string"
    },
    "canonical": {
     "type": "boolean"
    },
    "mid_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "base_token": {
     "type": "string"
    },
    "mark_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "quote_token": {
     "type": "string"
    },
    "total_supply": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "day_volume_usd": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "market_cap_usd": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "prev_day_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "day_volume_base": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "circulating_supply": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string"
  },
  "market": {
   "type": "string",
   "const": "spot"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-spot-market-data-by-token-symbol-c9b1a195/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)