{"uid":"cap_6YpCJt3oDSbo4APNHzIEX","slug":"chainray-token-sentiment-ce2e4982","name":"ChainRay Token Sentiment","description":"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.","url":"https://chainray.online/sentiment/%7Btoken%7D","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"object","additionalProperties":true},"example":{"request":{"chain":"ethereum"},"response":{"chain":"ethereum","token":"{TOKEN}","_proof":{"chain":"ethereum","dataHash":"5a491aebe9e1b44621938fa76f7f6c3518c6d25d0fc5b8aa803657e44f061c55","blockHash":"0x0b2fc57670784f49cc92eef2a111389651c74ca2a84fbd073896186d2bbcdc52","chainName":"Ethereum","blockNumber":25299131,"analysisHash":"3ceedb1b87b936076dd49cbcfb1f8ca35dedb326cc57988e96a84e36f242a99f","proofVersion":"3.0","blockTimestamp":1781240111,"proofTimestamp":1781240117634},"signals":{"newsNlp":{"note":"News NLP data unavailable, using on-chain signals","available":false},"gasLevel":{"unit":"gwei","signal":0,"weight":0.35,"currentGas":0.1559,"dataSource":"on-chain"},"gasTrend":{"value":"stable","signal":0.1,"weight":0.35,"dataSource":"on-chain"},"chainHealth":{"signal":0.2,"weight":0.3,"dataSource":"on-chain"},"socialActivity":{"note":"Social data unavailable","available":false}},"sources":["on-chain"],"sentiment":"slightly_bullish","timestamp":1781240117548,"confidence":0.58,"oracleType":"token-sentiment","methodology":"Token Sentiment v2.0 — On-chain only mode (NLP sources temporarily unavailable). 3-signal weighted composite from real block data.","priceContext":{"nativeTokenUsd":1676.4},"sentimentScore":0.1}},"exampleRequest":{"chain":"ethereum"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YmL2T88ikO3ajp1m5_z08","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain sentiment data for a specified cryptocurrency token, optionally filtered by blockchain.","exampleAgentPrompt":"What's the current on-chain sentiment for UNI token on Ethereum — is the market feeling bullish or bearish right now?","exampleUseCases":[{"title":"Pre-trade sentiment check for ETH","prompt":"Before I make my next ETH trade, can you pull the latest on-chain sentiment for Ethereum and tell me whether the market is leaning bullish or bearish right now?"},{"title":"Compare DeFi token sentiment across chains","prompt":"I'm looking at MATIC and SOL for a DeFi position — can you grab the on-chain sentiment for both tokens and let me know which one has more positive market signals at the moment?"},{"title":"Monitor BTC sentiment for portfolio alerts","prompt":"Keep an eye on the on-chain sentiment for BTC and let me know if it shifts from bullish to bearish or neutral — I want to be the first to know if the mood around Bitcoin starts turning negative."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:52:15.142Z","isFirstParty":false}