Repository navigation
feat: CoinGecko trending + price column (45th column type) - #44
Merged
Merged
Conversation
Closes the crypto-monitoring gap in minitor's Apps & on-chain cluster.
wallet-tx covers on-chain transactions and polymarket covers prediction
markets, but neither shows token prices or trending coins — the most
obvious "what's hot in crypto right now" signal. CoinGecko's free,
keyless API is the standard answer.
Three modes:
- trending: 24h search-volume leaderboard (fixed 7 coins, /search/trending)
- top: market-cap leaderboard with full pagination (/coins/markets)
- watchlist: custom comma-separated list of CoinGecko ids
Keyless by default; set COINGECKO_DEMO_API_KEY for higher rate limits.
The integration auto-routes to pro-api.coingecko.com when a key is
present (anonymous requests to the pro host return 401, so the keyless
path stays on api.coingecko.com).
Three integration quirks worth flagging:
1. The trending endpoint returns prices as USD-prefixed strings with
thousand-separators ("$1,234.56"); the markets endpoint returns
them as plain numbers. The `num()` helper strips currency formatting
before parsing so a 5-digit BTC price doesn't collapse to 0.
2. `price_change_percentage_24h` is keyed by currency in the trending
response (`data.price_change_percentage_24h.usd`) but flat in the
markets response (`price_change_percentage_24h`). The mapper
normalises both into a single `priceChange24h` field.
3. The watchlist `ids=` filter ignores `order` + `per_page`, but we
pass them anyway for forward-compatibility. Empty watchlist falls
back to top-by-cap so a freshly-added column isn't a dead box.
Row layout: CoinGecko brand chip (#8DC647 green, distinct from
wallet-tx #627eea and polymarket #2D9CDB blues) + market-cap rank +
relative time + coin icon (lazy <img>) + name + price + 24h change
arrow + optional 7-day sparkline + MC + 24h volume.
Plugin (3 files) + 3 registry edits + new lib/integrations/coingecko.ts.
README cluster row Apps & on-chain 4 → 5, count 44 → 45, keyless list
updated, .env.example documents the optional COINGECKO_DEMO_API_KEY.
May-18 idea #4.
Both PRs added a new column type at the same registry insertion points. Keep both plugins active: coingecko + github-discussions both appear in manifest / registry / server-registry, and the README reflects both surfaces. - README.md — column-list paragraph, "X column types" bullet bumped to 46, Keys section merges both COINGECKO_DEMO_API_KEY and GITHUB_TOKEN - lib/columns/plugins/manifest.ts — both meta imports + entries - lib/columns/registry.ts — both client imports + entries - lib/columns/server-registry.ts — both server imports + entries
aaronjmars
added a commit
that referenced
this pull request
May 19, 2026
Closes the crypto-monitoring gap in minitor's Apps & on-chain cluster.
wallet-tx covers on-chain transactions and polymarket covers prediction
markets, but neither shows token prices or trending coins — the most
obvious "what's hot in crypto right now" signal. CoinGecko's free,
keyless API is the standard answer.
Three modes:
- trending: 24h search-volume leaderboard (fixed 7 coins, /search/trending)
- top: market-cap leaderboard with full pagination (/coins/markets)
- watchlist: custom comma-separated list of CoinGecko ids
Keyless by default; set COINGECKO_DEMO_API_KEY for higher rate limits.
The integration auto-routes to pro-api.coingecko.com when a key is
present (anonymous requests to the pro host return 401, so the keyless
path stays on api.coingecko.com).
Three integration quirks worth flagging:
1. The trending endpoint returns prices as USD-prefixed strings with
thousand-separators ("$1,234.56"); the markets endpoint returns
them as plain numbers. The `num()` helper strips currency formatting
before parsing so a 5-digit BTC price doesn't collapse to 0.
2. `price_change_percentage_24h` is keyed by currency in the trending
response (`data.price_change_percentage_24h.usd`) but flat in the
markets response (`price_change_percentage_24h`). The mapper
normalises both into a single `priceChange24h` field.
3. The watchlist `ids=` filter ignores `order` + `per_page`, but we
pass them anyway for forward-compatibility. Empty watchlist falls
back to top-by-cap so a freshly-added column isn't a dead box.
Row layout: CoinGecko brand chip (#8DC647 green, distinct from
wallet-tx #627eea and polymarket #2D9CDB blues) + market-cap rank +
relative time + coin icon (lazy <img>) + name + price + 24h change
arrow + optional 7-day sparkline + MC + 24h volume.
Plugin (3 files) + 3 registry edits + new lib/integrations/coingecko.ts.
README cluster row Apps & on-chain 4 → 5, count 45 → 46, keyless list
updated, .env.example documents the optional COINGECKO_DEMO_API_KEY.
May-18 idea #4.
Co-authored-by: aeonframework <aeonframework@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds CoinGecko as minitor's 45th column type: keyless trending + top-by-cap + watchlist crypto price feed. Three modes, all keyless by default.
Why
The Apps & on-chain cluster covers wallet activity (
wallet-tx) and prediction markets (polymarket) but had no price or trending-coin signal — the most obvious entry point for the crypto-native audience that already accounts for a large slice of minitor's user base. Today's repo-actions audit flagged this as the highest-impact gap once you take aeon's skill-leaderboard into account (token-movers, token-pick, defi-monitor are among the most-adopted aeon skills, signalling a heavy crypto operator population).CoinGecko is the obvious provider: free, keyless, three useful endpoints (
/search/trending,/coins/markets, watchlist viaids=), and high enough rate limits for low-traffic decks. OptionalCOINGECKO_DEMO_API_KEYupgrades to the Demo plan ceiling without changing the column UX.Modes
/api/v3/search/trending— 24h search-volume leaderboard (fixed 7 coins; no pagination, fast)./api/v3/coins/markets?order=market_cap_desc— market-cap leaderboard with full pagination, sparkline included.coins/marketsendpoint withids=filter. Accepts comma-, semicolon-, or whitespace-separated CoinGecko ids (lowercase slugs —bitcoinnotBTC).Changes
lib/integrations/coingecko.ts— new (228 lines). Three integration quirks documented in the file:/search/trendingreturns USD prices as$1,234.56strings;/coins/marketsreturns them as numbers. Thenum()helper strips currency formatting before parsing — without this a 5-digit BTC price would collapse to 0.price_change_percentage_24his a currency-keyed object on/trending(data.price_change_percentage_24h.usd) but a flat number on/markets. The two mappers normalise both into a singlepriceChange24hfield.pro-api.coingecko.comreturn 401. Public host stays as the default; only swap to pro whenCOINGECKO_DEMO_API_KEYis set.lib/columns/plugins/coingecko/{plugin,server,client}.tsx— new (3-file plugin pattern, matchescrates/npm/pypi).lib/columns/plugins/manifest.ts,registry.ts,server-registry.ts— registry parity entries.README.md— count 44 → 45, Apps & on-chain cluster 4 → 5, keyless list + key documentation updated..env.example— documents the optionalCOINGECKO_DEMO_API_KEY.Row layout
Brand chip (#8DC647 CoinGecko green; sits clearly apart from
wallet-tx#627eea andpolymarket#2D9CDB blues) → market-cap rank → relative time → coin icon (<img loading="lazy">like the rest of the plugin set) → name → price (formatted with sub-cent precision for low-value coins) → 24h-change arrow with red/green colour → optional 7-day sparkline (SVG, no library) → market cap → 24h volume.Notes
category: "blockchain"(matcheswallet-tx+polymarket).May-18 idea #4 — keeps minitor's Apps & on-chain cluster moving and matches the audience that's already in the door from the aeon side.
Built autonomously by Aeon