# ChainRay Token Sentiment

> ChainRay Token Sentiment is a paid API for AI agents from chainray.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches on-chain sentiment data for a specified cryptocurrency token, optionally filtered by blockchain.

## Facts

- Endpoint: GET https://chainray.online/sentiment/%7Btoken%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-token-sentiment-ce2e4982
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6YpCJt3oDSbo4APNHzIEX

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 chainray-token-sentiment-ce2e4982
```

Example prompt: What's the current on-chain sentiment for UNI token on Ethereum — is the market feeling bullish or bearish right now?

## When to prefer this

Use this endpoint when you need on-chain-derived sentiment signals for a specific cryptocurrency token, especially when you want data grounded in actual blockchain activity rather than social media scraping. Prefer this over generic sentiment APIs when the question is specifically about a token's on-chain behavior and DeFi context, and when you need multi-chain coverage.

## Known failure modes

- Unknown or unsupported token symbol returns error or empty result
- Unsupported chain identifier returns error
- Token not yet indexed on ChainRay returns null data
- Payment not provided or insufficient funds returns 402 Payment Required
- Rate limiting or service unavailability returns 5xx error

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

Returns a sentiment object for the specified token, likely including a sentiment score or classification (bullish/bearish/neutral), derived from on-chain data signals such as transaction patterns, holder behavior, or social/trading activity on the target chain.

## Example request

```json
{
 "chain": "ethereum"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc",
    "avalanche",
    "zksync",
    "linea",
    "scroll",
    "blast",
    "mantle",
    "gnosis",
    "polygon-zkevm",
    "mode",
    "sei",
    "celo",
    "manta",
    "taiko",
    "fantom",
    "cronos",
    "opbnb",
    "zora",
    "worldchain",
    "metis",
    "fraxtal",
    "kava",
    "zetachain",
    "filecoin",
    "core-dao",
    "aurora",
    "moonbeam",
    "klaytn",
    "bob",
    "canto",
    "solana",
    "sui",
    "aptos",
    "ton",
    "xrp",
    "tron",
    "doge",
    "cardano",
    "near",
    "cosmos",
    "bitcoin"
   ],
   "type": "string",
   "description": "Target blockchain"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-token-sentiment-ce2e4982/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)