meme-rush

SKILL.md

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

User intent
Command

New / finalizing / migrated meme tokens on a launchpad
meme-rush

AI-generated market hot topics and their associated tokens
topic-rush

Supported Chains

Chain
chainId
Supported on

BSC
56
meme-rush, topic-rush

Solana
CT_501
meme-rush, topic-rush

Base
8453
meme-rush

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

Command
Purpose
Required args
Example

meme-rush
Launchpad token lifecycle ranking (new / finalizing / migrated)
chainId, rankType
node <skill-dir>/scripts/cli.mjs meme-rush '{"chainId":"CT_501","rankType":10,"limit":20}'

topic-rush
AI-generated hot topics with associated tokens
chainId, rankType, sort
node <skill-dir>/scripts/cli.mjs topic-rush '{"chainId":"CT_501","rankType":10,"sort":10}'

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.