# Token OHLCV Candles — klymax402

> Token OHLCV Candles — klymax402 is a paid API for AI agents from klymax402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns OHLCV (open, high, low, close, volume) candlestick data for a crypto token by CoinGecko ID or on-chain contract address, across configurable time intervals and history windows.

## Facts

- Endpoint: GET https://klymax402.com/api/token-ohlcv/api/candles
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Success rate: 0% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-ohlcv-candles-klymax402-57435107
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_55ro-OpvaOgSULYbprIOG

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 token-ohlcv-candles-klymax402-57435107
```

Example prompt: Can you pull the last 30 days of daily candlestick (OHLCV) data for Bitcoin using its CoinGecko ID 'bitcoin'?

## When to prefer this

Use this endpoint when you need structured OHLCV candlestick data for a specific crypto token identified either by CoinGecko ID or on-chain contract address, across multiple blockchains, with flexible interval granularity (daily, 4h, 1h). Prefer this over generic price endpoints when you need chart-ready time-series data with volume included, especially for DeFi or newer tokens only identifiable by contract address.

## Known failure modes

- Invalid or unknown CoinGecko token ID returns empty candles or an error
- Contract address not found on specified chain returns no data
- Interval not supported for the requested day range (e.g. 1h with days > 2) causes an error or fallback
- Missing required token or contract parameter causes a validation error
- Exceeding max days limit (365) returns an error

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

A JSON object containing a list of OHLCV candles (each with open, high, low, close, and volume values), the token ID, the data source (CoinGecko or GeckoTerminal), the candle interval used, and a result count.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "days": {
       "type": "number",
       "description": "Number of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days."
      },
      "chain": {
       "type": "string",
       "description": "Blockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc."
      },
      "token": {
       "type": "string",
       "description": "CoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain."
      },
      "contract": {
       "type": "string",
       "description": "On-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup."
      },
      "interval": {
       "type": "string",
       "description": "Candle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "example",
  "candles": [],
  "results": 1,
  "tokenId": "example",
  "interval": "example"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-ohlcv-candles-klymax402-57435107/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)