# Citiview Token Price by Contract Address

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

Returns USD price and 24-hour change for up to 30 tokens by contract address across 9 chains, covering long-tail DEX tokens

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/token/price?utm_source=zero.xyz
- Price: $0.002/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-by-contract-address-733026da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SfHY3-qZiDJNPEmxX2OIQ

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-by-contract-address-733026da
```

Example prompt: What's the current USD price and 24-hour change for the token at contract address 0x4200000000000000000000000000000000000006 on Base?

## When to prefer this

Use this endpoint when you need USD prices for tokens identified only by contract address, especially for long-tail or newly launched DEX tokens that ticker-symbol feeds (like CoinGecko or CoinMarketCap top-lists) do not cover. Ideal when you need multi-chain batch pricing for up to 30 tokens in one call. Prefer over ticker-based APIs when the token lacks a well-known symbol or is primarily traded on DEXes.

## Known failure modes

- Invalid or unrecognized contract address returns no price data
- More than 30 addresses in a single request may be rejected
- Unsupported chain name returns an error or empty result
- Very illiquid tokens with no recent trades may have missing or stale price data
- Network timeouts on high-traffic chains

## How this service works

USD price and 24h change for any token by contract address (up to 30 at once) on Base, Ethereum, Polygon, Arbitrum, Optimism, BSC, Avalanche, Solana or World Chain. Covers long-tail DEX tokens that ticker-based price feeds miss.

## Output

Returns USD price and 24-hour percentage change for each queried token contract address, covering tokens traded on DEXes across Base, Ethereum, Polygon, Arbitrum, Optimism, BSC, Avalanche, Solana, and World 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 | worldchain"
      },
      "address": {
       "type": "string",
       "description": "Token contract, or comma list (max 30)"
      }
     }
    }
   },
   "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-by-contract-address-733026da/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)