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.
Agent
1 endpointsToken
19 endpoints/token/:id/btc-dominance
Token market cap vs BTC
Token market cap as a percentage of Bitcoin market cap over time.
/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/fear-greed-index
Token Fear and Greed index
Fear and Greed index time-series for the token (0–100 scale). Diagnostics are omitted by default; pass debug=true to include model diagnostic fields.
/token/:id/follower-history
Token follower history
Total follower counts over time for the token. Query by days.
/token/:id/intelligence
Token intelligence
Paginated curated intelligence for the token. Filter by time range, tags, and 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. Optionally scope to a subset of social clusters via `clusters` (repeatable): with no clusters it's the token's share of all crypto attention; with clusters it's the token's share of attention within those clusters.
/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
Smoothed sentiment series (summary and cohorts). Optionally scope to a subset of social clusters via `clusters` (repeatable); the merged series is returned in `summary`. `clusters=smart_money` supersedes the dedicated smart-money-sentiment endpoint.
/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
Deprecated / redundant: prefer /token/{id}/simple-sentiment?clusters=smart_money. Sentiment time-series from smart money cohort only. Retained for backward compatibility.
/token/:id/social-momentum
Token social momentum
Per-cluster social momentum: post volume, sentiment split (bullish/bearish/neutral) and unique posters over time, broken out by author cluster (e.g. day_trader, bots, vcs, media). Shows how broadly a token's chatter is spreading across social space and which cohorts drive it. The series is sparse — buckets in which a cluster had no posts are omitted.
/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.
Utility
4 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/search
Token search
Search tokens by symbol, name, or contract address. Returns matching tokens ordered by relevance. Use q for the query string and limit (max 50) to cap results.
/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).
/users/search
Account search
Search tracked accounts by display name or handle. Returns matching accounts ordered by relevance. Use q for the query string and limit (max 50) to cap results.