# JarvisClaw Marketplace Candles API

> JarvisClaw Marketplace Candles API is a paid API for AI agents from uat.jarvisclaw.ai, paid per call via x402, $0.0011/call, status unknown (last checked 2026-09-14).

Fetches OHLCV candlestick (price candle) data for trading pairs from a marketplace via an AI API gateway with pay-per-call x402 micropayments.

## Facts

- Endpoint: GET https://uat.jarvisclaw.ai/v1/marketplace/markets/candles
- Price: $0.0011/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jarvisclaw-marketplace-candles-api-b985681a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AIx-HLP_dA_t06Mt9ojbE

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 jarvisclaw-marketplace-candles-api-b985681a
```

Example prompt: Can you pull the last 24 hourly candles for the BTC/USDC market from JarvisClaw so I can see the recent price action?

## When to prefer this

Use this endpoint when you need candlestick/OHLCV price data for crypto trading pairs accessible via micropayment (x402/USDC), especially when integrating with an AI agent workflow that uses pay-per-call billing. Prefer this over traditional exchange APIs when you need OpenAI-compatible gateway routing with on-chain settlement on Base or Solana.

## Known failure modes

- Invalid or unsupported trading pair returns an error response
- Unsupported time interval/granularity returns a bad request error
- Payment not settled via x402 results in 402 Payment Required
- Rate limiting or quota exceeded returns an appropriate error
- UAT environment instability may cause intermittent failures
- Malformed query string returns a validation error

## How this service works

AI API Gateway with smart routing, pay per call via x402. OpenAI-compatible. Settled in USDC on Base & Solana.

## Output

Returns OHLCV candlestick data for the specified market and time interval, including open, high, low, and close prices along with volume and timestamps for each candle period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Request parameters"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jarvisclaw-marketplace-candles-api-b985681a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uat.jarvisclaw.ai](https://www.zero.xyz/host/uat.jarvisclaw.ai/llms.txt)
