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.

meme-rush — CLI Reference

Complete reference for every command in scripts/cli.mjs.

Invocation pattern: node <skill-dir>/scripts/cli.mjs <command> '<json_params>' Exit codes: 0 success · 1 usage/upstream error · 3 network failure

Supported chains: BSC (56), Solana (CT_501).

---

meme-rush — Launchpad lifecycle tracking

⚠️ rankType selects the lifecycle stage: 10=New (freshly created, on bonding curve) · 20=Finalizing (bonding curve nearly complete, about to migrate) · 30=Migrated (just migrated to DEX).

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

Parameters (body is a JSON object; only chainId + rankType are required)

Core:

Token filters (Min/Max pairs): progress (string, 0–100) · tokenAge (long) · holders (long) · liquidity (string) · volume (string) · marketCap (string) · count / countBuy / countSell (long).

Holder distribution filters (Min/Max, string %): holdersTop10Percent · holdersDevPercent · holdersSniperPercent · holdersInsiderPercent · bundlerHoldingPercent · newWalletHoldingPercent · bnHoldingPercent · bnHolders (long) · kolHolders (long) · proHolders (long).

Dev & launch filters: devMigrateCountMin/Max (long) · devPosition (2=dev sold all) · devBurnedToken (1=yes) · excludeDevWashTrading (1=yes) · excludeInsiderWashTrading (1=yes).

Other filters: protocol (int[]; see Protocol Reference below) · exclusive (1=Binance exclusive) · paidOnDexScreener · pumpfunLiving · cmcBoost · globalFeeMin/Max (Solana only) · pairAnchorAddress (string[]) · tokenSocials.atLeastOne (1=yes) · tokenSocials.socials (string[]: website / twitter / telegram).

Protocol Reference

Complete list of protocol codes (used in protocol[] filter and returned on each token).

Return fields (under .data[])

Core:

Trade counts: count / countBuy / countSell (long, 24h).

Holder distribution (all string %, append `%` directly): holdersTop10Percent · holdersDevPercent · holdersSniperPercent · holdersInsiderPercent · bnHoldingPercent · kolHoldingPercent · proHoldingPercent · newWalletHoldingPercent · bundlerHoldingPercent.

Dev & migration: devAddress · devSellPercent · devMigrateCount · devPosition (2=dev sold all) · migrateStatus (0/1) · migrateTime · createTime.

Tags & flags: tagDevWashTrading · tagInsiderWashTrading · tagDevBurnedToken · tagPumpfunLiving · tagCmcBoost · paidOnDexScreener · launchTaxEnable · taxRate · globalFee (Solana only).

Socials: socials.website / socials.twitter / socials.telegram.

AI narrative: narrativeText.en / narrativeText.cn.

---

topic-rush — AI-powered hot-topic discovery (GET)

⚠️ rankType: 10=Latest (newest hot topics) · 20=Rising (topics with ATH net-inflow between $1k and $20k).

⚠️ `sort` default convention: when the user does not specify a preference, use sort=10 (create time). sort=20 = net inflow.

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

Parameters

Return fields (under .data[])

Topic-level:

Associated tokens (tokenList[] within each topic):

Nested shape: each topic has name: {topicNameEn, topicNameCn} (and aiSummary similarly) plus tokenList[] with full per-token stats inline.

---

Errors

Exit codes: 0 ok · 1 upstream/usage (stderr: reason; stdout: body with business code) · 3 network. Business code: 000000 ok · 100004 rate-limited · 100002 bad param · 000400 token not found / unsupported chain.

---

Notes

• Percentage fields (progress, holder %, devSellPercent, taxRate, priceChange24h) are pre-formatted — append % directly, do not multiply by 100.
• taxRate visibility: protocol=2001 (Four.meme) only on Migrated (rankType=30); protocol=2002 (Flap) on all lists.