# Liminal Spot Prices

> Liminal Spot Prices is a paid API for AI agents from x402-spot-prices.hsharmanov02.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns live cryptocurrency spot prices in USD and fiat FX rates, fetched from CoinGecko, via a pay-per-request x402 micropayment model

## Facts

- Endpoint: GET https://x402-spot-prices.hsharmanov02.workers.dev/price?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/liminal-spot-prices-1b212cab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_22Tq2Z7fRTWgsURBVetr9

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 liminal-spot-prices-1b212cab
```

Example prompt: What are the current spot prices for bitcoin and ethereum right now, including their 24-hour price changes?

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-request crypto spot price snapshot without a subscription or API key, especially in agentic workflows that support x402 micropayments. It's ideal for one-off price checks, portfolio valuation steps, or trigger evaluations where you want to avoid monthly API key commitments. Prefer alternatives with free tiers if you need very high-frequency polling or bulk historical data.

## Known failure modes

- HTTP 402 with base64 PAYMENT-REQUIRED header if no payment signature is provided — must retry with valid PAYMENT-SIGNATURE header
- Invalid or unsupported coin/currency query returns empty or error response
- Stale snapshot if CoinGecko upstream is delayed
- Network timeout from Cloudflare Worker edge if upstream is unavailable
- Payment rejected if USDC balance is insufficient or wrong chain is used

## How this service works

Live crypto spot-price snapshots (USD) and fiat FX spot rates. Pay-per-request via x402 v2: $0.01 USDC on Base, Monad, Arbitrum, Optimism, Polygon, Avalanche or Solana (eip155:8453), Monad (eip155:143), Arbitrum (eip155:42161), Optimism (eip155:10), Polygon (eip155:137), Avalanche (eip155:43114) or Solana, scheme exact (EIP-3009). Unpaid calls return HTTP 402 with a base64 PAYMENT-REQUIRED header; retry with a PAYMENT-SIGNATURE header.

## Output

A JSON object containing a Unix timestamp (as_of), a prices map keyed by coin name with USD spot price and 24-hour percentage change, the data source (CoinGecko), service name, and the vs_currency used (usd).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": true
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": true
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": 1759099200,
  "prices": {
   "bitcoin": {
    "usd": 114230.5,
    "usd_24h_change": 1.24
   },
   "ethereum": {
    "usd": 4281.1,
    "usd_24h_change": -0.63
   }
  },
  "source": "coingecko",
  "service": "spot-price",
  "vs_currency": "usd"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/liminal-spot-prices-1b212cab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-spot-prices.hsharmanov02.workers.dev](https://www.zero.xyz/host/x402-spot-prices.hsharmanov02.workers.dev/llms.txt)