Meme Rush

Meme Rush Skill

Overview

Two rank feeds fronted by one CLI: meme-rush (launchpad lifecycle tracking) and topic-rush (AI hot-topic discovery with associated tokens). The CLI owns URL, method, JSON encoding, timeout, and upstream error mapping — the agent only picks the subcommand and fills the filter JSON.

When to Use This Skill

Supported Chains

How to Call APIs

node <skill-dir>/scripts/cli.mjs meme-rush '{"chainId":"CT_501","rankType":10,"limit":20}'
node <skill-dir>/scripts/cli.mjs topic-rush '{"chainId":"CT_501","rankType":10,"sort":10,"asc":false}'

Commands

Optional filters for meme-rush (all min/max pairs): progress, tokenAge, holders, liquidity, volume, marketCap, count{,Buy,Sell}, holders{Top10,Dev,Sniper,Insider}Percent, bundlerHoldingPercent, newWalletHoldingPercent, bnHoldingPercent, {bn,kol,pro}Holders, devMigrateCount, globalFee; plus keywords, excludes, limit (max 200), protocol[], devPosition, devBurnedToken, excludeDevWashTrading, excludeInsiderWashTrading, exclusive, paidOnDexScreener, pumpfunLiving, cmcBoost, pairAnchorAddress[], tokenSocials.atLeastOne, tokenSocials.socials[]. See references/cli.md for type and semantics of each field.

Optional filters for topic-rush: asc (boolean), keywords, topicType, tokenSizeMin/Max, netInflowMin/Max.

Rules

• `meme-rush` `rankType` enum — stage of the token's launchpad lifecycle:
• 10 = New (freshly created, still on bonding curve)
• 20 = Finalizing (bonding curve nearly complete, about to migrate)
• 30 = Migrated (just migrated to DEX)
• `topic-rush` `rankType` enum — topic freshness:
• 10 = Latest (newest hot topics)
• 20 = Rising (rising topics, all-time-high inflow between $1k–$20k)
• `topic-rush` `sort` enum: 10 = create time, 20 = net inflow. Default to `sort=10` when the user does not specify a sort preference.
• Only `chainId` and `rankType` are required for meme-rush; all other parameters are optional filters. topic-rush additionally requires sort.
• Percentage fields are pre-formatted — progress, holder %, devSellPercent, taxRate, priceChange, priceChange24h are already strings like "42.5", so append `%` directly when displaying; do NOT multiply by 100.
• Icon URL prefix: icon is a relative path returned by upstream; prepend https://bin.bnbstatic.com before rendering. tokenList[].icon in topic-rush responses follows the same rule.
• `taxRate` visibility: for protocol=2001 (Four.meme) taxRate only appears on the Migrated list; for protocol=2002 (Flap) it appears on all lists.
• Protocol codes (1001–2002) map to specific launchpads (Pump.fun, Moonit, Pump AMM, Raydium V4/CPMM/CLMM, BONK, Dynamic BC, Moonshot, Jup Studio, Bags, Believer, Meteora DAMM V2 / Pools, Orca, Four.meme, Flap). See references/cli.md for the full table.

Full CLI Reference

See `references/cli.md` for per-subcommand invocations, full parameter tables (all filter fields, holder-distribution filters, dev & launch filters), return-field tables (core, trade counts, holder distribution, dev & migration, tags & flags, social links, AI narrative, topic + tokenList), and real response samples.