Ruma Public API
Reference index
Every endpoint below has a stable HTML page and a Markdown twin. This index is static, crawlable, and safe for AI agents to read without executing JavaScript.
Token
18 endpoints/token/:id/btc-dominance
Token BTC dominance
Market cap vs BTC dominance time-series for the token.
/token/:id/cultiness-index
Token cultiness index
Cultiness index time-series for the token.
/token/:id/dumb-money-sentiment
Token dumb money sentiment
Sentiment time-series from dumb money cohort only.
/token/:id/emotions-series
Token emotions series
Emotion distribution (joy, fear, etc.) over time for the token.
/token/:id/follower-history
Token follower history
Total follower counts over time for the token. Query by days.
/token/:id/fomo-fud-index
Token FOMO/FUD index
FOMO & FUD index time-series for the token (0–100 scale).
/token/:id/insights
Token insights
Paginated list of insights for the token. Filter by time range, tags, order.
/token/:id/long-short-ratio
Token long/short ratio
Counts of unique long vs short callers over time for the token.
/token/:id/mindshare
Token mindshare
Mindshare (social attention) time-series for the token.
/token/:id/post-volume
Token post volume
Post volume time-series for the token (all authors).
/token/:id/sentiment-timeframes
Token sentiment timeframes
Sentiment broken down by short/medium/long timeframes.
/token/:id/simple-sentiment
Token simple sentiment
Simplified sentiment series (summary and cohorts).
/token/:id/smart-money-bias
Token smart money bias
Current bias (smart money sentiment minus overall sentiment) in basis points.
/token/:id/smart-money-post-volume
Token smart money post volume
Post volume time-series from smart money (giga brain) cohort only. Note: /token/{id}/smartmoney-post-volume is a deprecated alias and will be removed after 30 days.
/token/:id/smart-money-sentiment
Token smart money sentiment
Sentiment time-series from smart money cohort only.
/token/:id/top-degens-sentiment
Token top degens sentiment
Sentiment time-series from top degens cohort only.
/token/:id/volatility-index
Token volatility index
Volatility index time-series for the token.
/token/:id/volume-series
Token volume series
Trading volume time-series for the token over the lookback window.
Accounts
1 endpointsUtility
2 endpoints/tokens
Token list (paged)
Paginated list of tokens with token_id, coingecko_id, symbol, name, price_usd, market_cap_usd, volume_usd, and address. Sorted by market_cap_usd DESC NULLS LAST by default. Use limit (max 500) and offset for paging.
/tokens/trending
Trending token list
Trending token snapshot sorted by mindshare_change DESC. Returns the same response shape as /tokens, with optional trend metrics (mindshare_24h, mindshare_change, mindshare_change_pct). Use limit (max 50).