# CryptoFeed402 Spot & Perp Price Lookup

> CryptoFeed402 Spot & Perp Price Lookup is a paid API for AI agents from cryptofeed402.site, paid per call via x402, $0.0025/call, status unknown (last checked 2026-10-21).

Returns real-time spot price and perpetual futures data (mark price, funding rate, open interest, 24h volume) for a single cryptocurrency symbol, paid via x402 micropayment in USDC on Base.

## Facts

- Endpoint: GET https://cryptofeed402.site/price/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptofeed402-spot-perp-price-lookup-99a088c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wrv39Vc37SF3jHcaVKD-y

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 cryptofeed402-spot-perp-price-lookup-99a088c3
```

Example prompt: What's the current BTC spot price and perpetual funding rate right now — including open interest and 24-hour volume?

## When to prefer this

Choose this endpoint when an AI agent needs low-latency, machine-payable (x402) real-time crypto pricing with both spot and perpetual futures context in a single call. Ideal for autonomous trading agents, DeFi bots, or portfolio monitors that can pay micropayments programmatically in USDC on Base. Best for the specific coins supported (BTC, ETH, SOL, HYPE, NEAR, AAVE) rather than broad market sweeps.

## Known failure modes

- 402 Payment Required — call made without valid x402 USDC payment header; response includes payment requirements
- Invalid symbol — symbol not in supported set (BTC, ETH, SOL, HYPE, NEAR, AAVE) returns error
- Network/venue outage — upstream data from Hyperliquid or OKX unavailable, may return stale or partial data
- Malformed request — missing or incorrectly formatted symbol path parameter

## How this service works

AI-to-AI crypto data. Paid routes use x402 (USDC on Base mainnet eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); unpaid calls return 402 with payment requirements. Not financial advice.

## Output

A JSON object with two sub-objects: 'spot' (last price, 24h open, 24h change percent, venue) and 'perp' (mark price, premium, hourly funding rate, funding APR percent, 24h volume in USD, open interest in USD and coins, venue), plus the symbol and an ISO 8601 timestamp of data freshness.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "perp": {
   "venue": "hyperliquid",
   "mark_px": 81390,
   "premium": -0.0002,
   "funding_hourly": 0.0000031,
   "volume_24h_usd": 2150000000,
   "funding_apr_pct": 2.72,
   "open_interest_usd": 3377685000,
   "open_interest_coins": 41500
  },
  "spot": {
   "last": 81388,
   "venue": "okx",
   "open_24h": 81495,
   "change_24h_pct": -0.13
  },
  "as_of": "2026-10-18T03:00:00.000Z",
  "symbol": "BTC",
  "disclaimer": "Automated data for AI agents. Not financial advice."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptofeed402-spot-perp-price-lookup-99a088c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cryptofeed402.site](https://www.zero.xyz/host/cryptofeed402.site/llms.txt)