# Citiview Token Price Chart

> Citiview Token Price Chart is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-14).

Returns OHLC price history time series for any DEX token contract address, with configurable intervals and point counts across multiple chains.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/token/chart?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-token-price-chart-aad6a54b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjqxNlv64v_rk4GeVFaLN

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 citiview-token-price-chart-aad6a54b
```

Example prompt: Can you pull the last 48 hourly OHLC candles for the token at contract address 0xabc123... on Base so I can see how its price has moved?

## When to prefer this

Choose this endpoint when you need historical OHLC candlestick price data for a specific DEX token contract, especially for tokens only traded on decentralized exchanges that may not appear in centralized exchange APIs. It supports multiple chains including Base, Ethereum, Solana, Polygon, Arbitrum, Optimism, BSC, and Avalanche, with flexible interval and point-count controls.

## Known failure modes

- Invalid or unrecognized contract address returns an error or empty series
- Unsupported chain name returns a validation error
- Points value outside 2–500 range is rejected
- Token with no DEX liquidity or trading history may return empty or sparse data
- Malformed interval string (e.g. '2h' instead of supported values) may return an error

## How this service works

Price history for any token contract: a time series at 5m to 1w intervals (up to 500 points) with open, close, high, low and percent change. Works for DEX-only tokens.

## Output

A time series array of OHLC (open, high, low, close) price data points with percent change, sampled at the requested interval (5m to 1w), up to 500 points, for the specified token contract address and chain.

## 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": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default) | ethereum | polygon | arbitrum | optimism | bsc | avalanche | solana"
      },
      "period": {
       "type": "string",
       "description": "Interval like 5m, 1h, 4h, 1d (default 1h)"
      },
      "points": {
       "type": "integer",
       "description": "2 to 500, default 24"
      },
      "address": {
       "type": "string"
      }
     }
    }
   },
   "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/citiview-token-price-chart-aad6a54b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)