GET /api/market/stats/:username
Returns social influence stats for a Twitter/X username based on their activity in the Elfa smart money index.
Request
GET https://api-nekosinga.vercel.app/api/market/stats/:username| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
username | path | string | ✅ | Twitter/X username without @, e.g. elonmusk |
No authentication required.
Response
{
"username": "cobie",
"elfaScore": 92,
"smartMoneyRank": 14,
"totalPosts": 3820,
"avgEngagement": 6.7,
"topTokens": ["BTC", "ETH", "SOL"],
"cachedAt": "2025-01-15T09:00:00Z"
}| Field | Type | Description |
|---|---|---|
username | string | Twitter/X username |
elfaScore | number | Elfa-assigned influence score (0–100) |
smartMoneyRank | number | Rank within the smart money index |
totalPosts | number | Total indexed posts |
avgEngagement | number | Average engagement score per post |
topTokens | string[] | Most mentioned token tickers |
cachedAt | string | ISO timestamp of last cache refresh |
Error
{ "error": "Username not found in index" }Returns 404 if the username is not in the Elfa smart money index.
Caching
TTL: 1 hour — cached in Upstash Redis. Cache key: market:stats:{username}.