# x402stock Spot Price via ZeroClick

> x402stock Spot Price via ZeroClick is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.02/call, status healthy (last checked 2026-10-29, last successful call 2026-10-15).

Returns the latest real-time spot price for US stocks, ETFs, forex, crypto, or commodities via pay-per-request with no API key required

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/spot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402, MPP
- Status: healthy
- Last checked: 2026-10-29
- Last successful call: 2026-10-15
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-spot-price-via-zeroclick-4a79c5c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sRVAxAwyyAn01VqgIvV7w

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-via-zeroclick-4a79c5c7
```

Example prompt: What is the current spot price of AAPL stock right now?

## When to prefer this

Use this endpoint when you need a fast, real-time spot price for a US stock, ETF, forex pair, crypto asset, or energy commodity without setting up an API account. It is ideal for AI agents operating autonomously that can pay per request in USDC via x402 micropayments. Prefer this over brokerage APIs when no persistent account or API key is available, and over free data providers when you need fresh, reliable pricing with clear per-call economics.

## Known failure modes

- Invalid or unsupported ticker symbol returns a 404 or error payload
- Market closed hours may return last available price rather than a live quote
- Payment failure or insufficient USDC balance prevents the request from completing
- Rate limiting or network errors may cause transient 5xx responses
- Unsupported asset class (e.g. unlisted foreign equity) returns an empty or error response

## How this service works

Live on-chain spot prices for every token on the Hyperliquid DEX.

## Output

Returns the latest available spot price for the requested asset, including the most recent trade price, timestamp, and relevant market metadata such as bid/ask spread where available. Delivered as a structured JSON response after a $0.02 USDC micropayment is processed automatically via x402.

## 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": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "market",
  "count",
  "pairs"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "pairs": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "pair",
     "id",
     "base_token",
     "quote_token",
     "canonical",
     "mark_price",
     "mid_price",
     "prev_day_price",
     "day_volume_usd",
     "day_volume_base",
     "circulating_supply",
     "total_supply",
     "market_cap_usd"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "pair": {
      "type": "string"
     },
     "canonical": {
      "type": "boolean"
     },
     "mid_price": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "base_token": {
      "type": "string"
     },
     "mark_price": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "quote_token": {
      "type": "string"
     },
     "total_supply": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "day_volume_usd": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "market_cap_usd": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "prev_day_price": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "day_volume_base": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "circulating_supply": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  },
  "venue": {
   "type": "string"
  },
  "market": {
   "type": "string",
   "const": "spot"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-spot-price-via-zeroclick-4a79c5c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)