# x402stock Spot Candles via ZeroClick

> x402stock Spot Candles via ZeroClick is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).

Returns OHLCV candlestick price data for a given token (stock, crypto, forex, or commodity) using pay-per-use x402 micropayments

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/spot/candles/%7Btoken%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-spot-candles-via-zeroclick-23aba7e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kVNDQqXFXoTYF_cMKsnrC

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-candles-via-zeroclick-23aba7e6
```

Example prompt: Can you pull up the candlestick price data for TSLA — I want the open, high, low, close, and volume bars so I can analyze the recent price action?

## When to prefer this

Use this endpoint when you need candlestick (OHLCV) price bar data for a broad range of assets — US stocks, ETFs, crypto, forex, or commodities — without needing an API key or account. Prefer this over traditional market data APIs when operating as an autonomous agent with USDC payment capability via x402, or when you want pay-per-use pricing with no subscription commitment.

## Known failure modes

- Invalid or unsupported token symbol returns an error or empty result
- Payment failure or insufficient USDC balance prevents data retrieval
- Token not listed on supported exchanges returns no data
- Network or proxy timeout from ZeroClick intermediary
- Rate limiting if too many concurrent requests are made

## How this service works

Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns a time series of OHLCV candlestick bars for the requested token, including open, high, low, close prices, trading volume, and VWAP per bar. Payment is deducted at $0.02 USDC per call via x402 micropayment protocol with no API key required.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-spot-candles-via-zeroclick-23aba7e6/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)