# DESK LEAD x402 – Pin Spot Price Lookup

> DESK LEAD x402 – Pin Spot Price Lookup is a paid API for AI agents from desk-x402.desk-x402-gh.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns the pinned spot price in USD for a given cryptocurrency symbol (WBNB, XRP, or USDC) via a micropayment-gated API using the x402 protocol.

## Facts

- Endpoint: GET https://desk-x402.desk-x402-gh.workers.dev/v1/pin-spot
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/desk-lead-x402-pin-spot-price-lookup-c97aeb9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oOXPQqoq31M6lULhOCumQ

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 desk-lead-x402-pin-spot-price-lookup-c97aeb9d
```

Example prompt: What's the current spot price of WBNB in USD? Use the pin-spot lookup and pay the small fee via x402 on Base.

## When to prefer this

Choose this endpoint when you need a low-cost ($0.05 USDC), on-demand spot price for WBNB, XRP, or USDC and can pay via the x402 micropayment protocol on the Base blockchain. It is ideal for agents that already support x402 payment flows and need a quick, lightweight price oracle without subscribing to a full market data API.

## Known failure modes

- Invalid or unsupported symbol — only WBNB, XRP, and USDC are accepted enum values
- Missing or invalid x402 payment header — returns 402 Payment Required if micropayment is not provided
- Payment on wrong network — v2 only accepts Base (eip155:8453); using BSC without legacy header causes rejection
- Missing required 'input' body object or wrong HTTP method — returns 400 Bad Request
- Upstream price feed unavailable — may return error or stale data

## How this service works

Micropay research APIs (x402 v2 + bazaar). Free catalog at /.well-known/x402.json. Primary v2 accepts: Base eip155:8453 only. Legacy X-PAYMENT-TX still supports bsc|base via acceptsV1. Headers: X-PAYMENT-TX, X-PAYMENT-NETWORK, PAYMENT-SIGNATURE. No financial advice.

## Output

Returns a JSON object with an 'ok' boolean indicating success, a 'usd' field containing the spot price as a number, and a 'product' field set to 'pin_spot' identifying the data product.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "symbol": {
       "enum": [
        "WBNB",
        "XRP",
        "USDC"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "usd": 0,
  "product": "pin_spot"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/desk-lead-x402-pin-spot-price-lookup-c97aeb9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from desk-x402.desk-x402-gh.workers.dev](https://www.zero.xyz/host/desk-x402.desk-x402-gh.workers.dev/llms.txt)
