GET /api/market/sentiment/:token
Returns a sentiment score for a specific token based on social media activity tracked by the Elfa API.
Request
GET https://api-nekosinga.vercel.app/api/market/sentiment/:token| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
token | path | string | ✅ | Token ticker symbol, e.g. BTC, ETH, SOL |
No authentication required.
Response
{
"token": "SOL",
"sentiment": "bullish",
"score": 0.74,
"totalMentions": 2103,
"smartMoneyMentions": 187,
"cachedAt": "2025-01-15T10:15:00Z"
}| Field | Type | Description |
|---|---|---|
token | string | Token ticker symbol |
sentiment | "bullish" | "bearish" | "neutral" | Aggregated sentiment label |
score | number | Sentiment score between -1 (bearish) and 1 (bullish) |
totalMentions | number | Total mentions in the current window |
smartMoneyMentions | number | Subset from tracked smart money accounts |
cachedAt | string | ISO timestamp of last cache refresh |
Error
{ "error": "Token not found" }Returns 404 if the token has no data in the Elfa index.
Caching
TTL: 15 minutes — cached in Upstash Redis. Cache key: market:sentiment:{token}.