# TokenGuard Kline (OHLCV Candlestick) API

> TokenGuard Kline (OHLCV Candlestick) API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns OHLCV (open/high/low/close/volume) candlestick/kline data for a cryptocurrency trading pair over a specified time interval

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/kline
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-kline-ohlcv-candlestick-api-bbd0174e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OZuDI8vLyLBfVBUFUln8o

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 tokenguard-kline-ohlcv-candlestick-api-bbd0174e -d '<json body>'
```

Example prompt: Can you pull the 1-hour OHLCV candlestick data for the ETH/USDT pair for the last 7 days so I can analyze the price trend?

## When to prefer this

Use this endpoint when you need structured OHLCV candlestick data for crypto trading pairs to power charts, technical indicators, or historical price analysis. It is part of the TokenGuard 65-route DeFi API suite, accessible via x402 micropayments on Base with no subscription required, making it ideal for pay-per-call agent workflows needing crypto market data without a centralized API key.

## Known failure modes

- Invalid or unsupported trading pair symbol returns an error or empty array
- Unsupported time interval value results in a validation error
- Start/end timestamps out of available data range return empty results
- Micropayment failure (x402) blocks the request if USDC balance is insufficient
- Rate limiting or service unavailability on Hugging Face Space returns 5xx errors

## How this service works

kline data for AI agents.

## Output

A JSON array of candlestick (OHLCV) records for the requested trading pair and interval, each containing open time, open price, high price, low price, close price, and trading volume over that period.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-kline-ohlcv-candlestick-api-bbd0174e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)