Skip to content

feat: CoinGecko trending + price column (45th column type) - #44

Merged
aaronjmars merged 2 commits into
mainfrom
feat/coingecko-column
May 19, 2026
Merged

aaronjmars merged 2 commits into
mainfrom
feat/coingecko-column

Conversation

@aaronjmars

Copy link
Copy Markdown
Collaborator

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 via ids=), and high enough rate limits for low-traffic decks. Optional COINGECKO_DEMO_API_KEY upgrades to the Demo plan ceiling without changing the column UX.

Modes

  • Trending — /api/v3/search/trending — 24h search-volume leaderboard (fixed 7 coins; no pagination, fast).
  • Top — /api/v3/coins/markets?order=market_cap_desc — market-cap leaderboard with full pagination, sparkline included.
  • Watchlist — same coins/markets endpoint with ids= filter. Accepts comma-, semicolon-, or whitespace-separated CoinGecko ids (lowercase slugs — bitcoin not BTC).

Changes

  • lib/integrations/coingecko.ts — new (228 lines). Three integration quirks documented in the file:
    1. Price-format normalisation. /search/trending returns USD prices as $1,234.56 strings; /coins/markets returns them as numbers. The num() helper strips currency formatting before parsing — without this a 5-digit BTC price would collapse to 0.
    2. Percentage field shape. price_change_percentage_24h is 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 single priceChange24h field.
    3. Host routing on key presence. Anonymous requests to pro-api.coingecko.com return 401. Public host stays as the default; only swap to pro when COINGECKO_DEMO_API_KEY is set.
  • lib/columns/plugins/coingecko/{plugin,server,client}.tsx — new (3-file plugin pattern, matches crates/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 optional COINGECKO_DEMO_API_KEY.

Row layout

Brand chip (#8DC647 CoinGecko green; sits clearly apart from wallet-tx #627eea and polymarket #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" (matches wallet-tx + polymarket).
  • Keyless by default; the Demo key only changes rate-limit ceiling and host, not features.
  • Watchlist input is normalised (lowercased, deduped, 50-id cap) so accidental "BTC" tickers don't silently fail — they just match nothing and the column shows empty.
  • Empty watchlist falls back to top-by-cap so a freshly-added column isn't a dead box while the operator types.

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

aeonframework and others added 2 commits May 19, 2026 11:39
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
aaronjmars merged commit 3c2fedd into main May 19, 2026
1 check passed
@aaronjmars
aaronjmars deleted the feat/coingecko-column branch May 19, 2026 19:28
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants