# x402stock Spot Order Book

> x402stock Spot Order Book is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the current spot order book (bids and asks) for a given token trading pair on Hyperliquid

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/spot/orderbook/%7Btoken%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-spot-order-book-7b278c2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0jTzTOnr_yvnQkTp8Bigw

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 x402stock-spot-order-book-7b278c2f
```

Example prompt: What does the current spot order book look like for PURR/USDC — show me the bids and asks with sizes and prices right now.

## When to prefer this

Use this endpoint when you need real-time spot order book depth for tokens trading on Hyperliquid DEX — specifically bid/ask price levels, order sizes, and market liquidity snapshots. Prefer this over generic price endpoints when you need full depth-of-market data rather than just a last-traded price. Ideal for agents performing arbitrage analysis, liquidity assessment, or market-making research on Hyperliquid spot pairs.

## Known failure modes

- Unknown or unsupported token symbol returns 404 or empty result
- Token pair with no active market returns empty bids/asks arrays
- Stale data if Hyperliquid feed is delayed
- Rate limiting or payment failure if USDC balance insufficient for x402 payment
- Malformed token path parameter returns 400 error

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a JSON object containing the token pair identifier, an array of ask levels (price, size, number of orders), an array of bid levels (price, size, number of orders), the venue (e.g. hyperliquid), market type (spot), and an as_of timestamp indicating when the snapshot was taken.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "PURR/USDC",
  "asks": [
   {
    "size": 1200,
    "price": 0.097,
    "orders": 6
   }
  ],
  "bids": [
   {
    "size": 1000,
    "price": 0.0969,
    "orders": 5
   }
  ],
  "pair": "PURR/USDC",
  "as_of": "2026-06-04T00:00:00.000Z",
  "venue": "hyperliquid",
  "market": "spot",
  "source": "x402stock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-spot-order-book-7b278c2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)