# cryptofeed402 Single-Asset Perp & Spot Snapshot

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

Returns a live snapshot of Hyperliquid perpetual market data (mark price, funding rate, open interest, volume) plus OKX spot price for one of six supported crypto assets.

## Facts

- Endpoint: GET https://cryptofeed402.site/price/:symbol?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptofeed402-single-asset-perp-spot-snapshot-00c55be2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cLaDK4Xu9KgXqIrmt9eGP

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-single-asset-perp-spot-snapshot-00c55be2
```

Example prompt: What's the current Hyperliquid mark price, funding rate, and open interest for ETH right now, plus the OKX spot price?

## When to prefer this

Use this endpoint when a trading agent needs a real-time, consolidated perp + spot snapshot for one of the six supported assets (BTC, ETH, SOL, HYPE, NEAR, AAVE) specifically from Hyperliquid perp and OKX spot markets. Prefer it over generic price APIs when Hyperliquid funding rate, open interest, and perp-vs-spot premium are required for trade sizing or timing decisions. Not suitable for assets outside the supported six, for historical data, or for exchange-agnostic best-price routing.

## Known failure modes

- Unsupported symbol: only BTC, ETH, SOL, HYPE, NEAR, AAVE are accepted; other tickers return an error
- Hyperliquid or OKX upstream outage may result in stale or missing data
- Spot object may be null if OKX data is unavailable for the requested asset
- Payment failure: x402 micropayment not processed, returning 402 status
- Network timeout if upstream exchanges are slow to respond

## How this service works

Live snapshot for one major coin (BTC, ETH, SOL, HYPE, NEAR, AAVE): Hyperliquid perp mark price, hourly funding rate and annualized funding APR, open interest in coins and USD, 24h volume and premium, plus OKX spot last price and 24h change. Use it when a trading agent needs current price and perp positioning for a single asset before sizing or timing a trade. JSON. $0.0025 USDC per call on Base.

## Output

A JSON object containing: the requested symbol, an ISO 8601 UTC timestamp, a 'perp' object with Hyperliquid mark price, hourly funding rate, annualized funding APR percentage, 24h volume in USD, open interest in both coins and USD, and perp premium; plus a 'spot' object (or null) with OKX last price, 24h open price, and 24h percentage change; and a disclaimer string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "enum": [
        "BTC",
        "ETH",
        "SOL",
        "HYPE",
        "NEAR",
        "AAVE"
       ],
       "type": "string",
       "description": "Coin ticker (case-insensitive)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "symbol",
      "as_of",
      "perp"
     ],
     "properties": {
      "perp": {
       "type": "object",
       "properties": {
        "venue": {
         "type": "string"
        },
        "mark_px": {
         "type": "number"
        },
        "premium": {
         "type": "number"
        },
        "funding_hourly": {
         "type": "number"
        },
        "volume_24h_usd": {
         "type": "number"
        },
        "funding_apr_pct": {
         "type": "number"
        },
        "open_interest_usd": {
         "type": "number"
        },
        "open_interest_coins": {
         "type": "number"
        }
       }
      },
      "spot": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "last": {
         "type": "number"
        },
        "venue": {
         "type": "string"
        },
        "open_24h": {
         "type": "number"
        },
        "change_24h_pct": {
         "type": "number"
        }
       }
      },
      "as_of": {
       "type": "string",
       "description": "ISO 8601 UTC timestamp"
      },
      "symbol": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptofeed402-single-asset-perp-spot-snapshot-00c55be2/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)