# x402stock Spot Price Lookup

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

Returns real-time spot market data (mid price, mark price, volume, market cap) for a crypto token pair on a specified venue

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/spot/%7Btoken%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-spot-price-lookup-1f47a5b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kbKFL2lLNMKa3NgKyHTow

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-price-lookup-1f47a5b6
```

Example prompt: What's the current spot price and market cap of HYPE on Hyperliquid right now?

## When to prefer this

Use this endpoint when you need real-time spot price and market data for a crypto token (especially on-chain/DeFi venues like Hyperliquid) without requiring API keys or account setup — and when your agent can pay $0.01 USDC per call via x402 on Base. Prefer this over traditional market data APIs when operating in a permissionless, pay-per-call agent context.

## Known failure modes

- Unknown or unsupported token symbol returns an error
- Payment not received via x402/USDC results in 402 Payment Required
- Malformed token path parameter returns a 400 or 404
- Venue temporarily unavailable may return stale or missing data
- Token with no spot market on the requested venue returns empty or error response

## 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 with the token pair identifier, mid price, mark price, previous day price, 24-hour volume in USD and base token, market cap in USD, circulating supply, total supply, canonical flag, venue name, market type, and timestamp of the data.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "@107",
   "pair": "HYPE/USDC",
   "canonical": false,
   "mid_price": 64.45,
   "base_token": "HYPE",
   "mark_price": 64.436,
   "quote_token": "USDC",
   "total_supply": 1000000000,
   "day_volume_usd": 3446893.64,
   "market_cap_usd": 21515620000,
   "prev_day_price": 61.519,
   "day_volume_base": 53570,
   "circulating_supply": 333928438
  },
  "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-price-lookup-1f47a5b6/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)