# token-price-candles

> token-price-candles is a paid API for AI agents from chain.intel.rallylive.ca, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Returns hourly OHLCV (open, high, low, close, volume) price candles for the last 7 days for any DEX token, sourced from its deepest liquidity pool, across multiple EVM chains.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/ohlcv?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-price-candles-07d175d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ylqfr51F7OyLnPw-G0Z7I

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-price-candles-07d175d2
```

Example prompt: Can you pull the hourly OHLCV candles for the last 7 days for this Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, including the period high, low, and change?

## When to prefer this

Choose this endpoint when you need historical hourly OHLCV candlestick data for a DEX token across Base, Ethereum, Arbitrum, Optimism, Polygon, or BSC — especially for charting, backtesting, or generating trading signals. Prefer this over a spot price endpoint when you need time-series data, period highs/lows, or volume history rather than just the current price.

## Known failure modes

- Token contract address not found or invalid — returns error or empty data
- Token has no DEX liquidity pool on the specified chain — no candle data available
- Unsupported chain prefix provided — may return error or default to Base
- Rate limiting or payment failure — returns 402 or 429 status
- Very new tokens with less than 7 days of trading history return partial candle sets

## How this service works

Hourly OHLCV price candles (last 7 days) for any DEX token from its deepest pool, with period change, high and low. For charting and trading signals. Default chain Base; prefix another: ethereum:, arbitrum:, optimism:, polygon:, bsc:. $0.02 per call.

## Output

Returns an array of hourly OHLCV candles covering the last 7 days for the specified token, drawn from its deepest DEX liquidity pool. Each candle includes open, high, low, close, and volume values. The response also includes the period's overall high, low, and percentage change — useful for charting and generating trading signals.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-price-candles-07d175d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.intel.rallylive.ca](https://www.zero.xyz/host/chain.intel.rallylive.ca/llms.txt)