/gmgn-heat-rank

name: gmgn-heat-rank
description: >-
  Produce THE list of tokens that are hot RIGHT NOW and safe enough to look at,
  across every chain GMGN supports, scored 0-100 and capped at ten names. This
  is a screening skill: it starts from no address, sweeps all seven chains,
  gates every candidate on liquidity / real volume / concentration / rug-and-dev
  risk, scores the survivors on one cross-chain scale, and returns however many
  clear the score floor — fewer than ten in a weak market, never padded to fill
  the quota. USE THIS SKILL WHEN the user wants a curated hot list rather than
  raw rankings: "热榜", "热门代币", "近期热门", "帮我抓一轮热榜", "现在有什么值得关注的热币",
  "全链热门币", "生成热榜", "有没有新的热门盘", "what is hot right now",
  "give me the hot list", "which trending tokens are actually worth looking at",
  "screen the trending list for me". The same questions in any other language
  route here too - match on meaning, not wording. DO NOT USE THIS SKILL for a
  raw ranking dump ("show me the top 20 by volume on sol", "1h trending",
  "hot search list") - that is `gmgn-market trending` / `hot-searches`, which
  returns the exchange's own ordering untouched; nor for freshly launched
  bonding-curve tokens ("just launched", "pump.fun new", "新盘") - that is
  `gmgn-market trenches`; nor for one address the user already has ("is this
  token safe", "打个分", "尽调") - that is `gmgn-contract-dd`; nor for a chart
  read ("走势怎么样", "什么形态") - that is `gmgn-kline-pattern`; nor for
  early-stage hunting below this skill's own floor ("值得埋伏吗", "新币筛选",
  "早期机会", "discover early-stage opportunities") - that is
  `gmgn-market trenches`, because the candidate pool here starts at 500k market
  cap and 100k liquidity and never contains a bonding-curve token; nor for the
  wallet-side view of the same market ("聪明钱在买什么", "KOL 在买什么",
  "on-chain alpha", "copy-trade signals") - that is `gmgn-track smartmoney` /
  `kol`, which answers who is buying rather than what is worth looking at. The
  split is by who chooses the tokens: if the user names the token, it is not
  this skill; if the user is asking the skill to choose, it is. When nobody names a token and
  the wording alone collides with `gmgn-market` - "hot coins", "what's pumping",
  "trending tokens", "热门币", "什么币在涨" - the deciding test is the shape of the
  answer being asked for: an untouched ranking of N rows in the exchange's own
  order is `gmgn-market trending`; a short list that survived risk gates, carries
  a score and can be acted on is this skill. A bare ambiguous ask with no other
  signal defaults here, because this skill can point at the raw ranking while the
  raw ranking cannot screen itself. Nothing has to be supplied to run it - the
  trigger phrase alone is enough, and no address, chain or amount is ever
  required. Four things can be narrowed when the user asks for it: which chains
  are swept, the age ceiling, how many names come back, and the score floor;
  any value changed that way is named in the report.
argument-hint: "[chains sol,bsc,base,eth,robinhood,arc,stable] [max-created 7d] [TOP_N 10] [MIN_SCORE 60]"
metadata:
  cliHelp: "gmgn-cli market trending --help"

**BEFORE RUNNING ANY COMMAND: Run `gmgn-cli config --check`. Exit 0 -> proceed. Exit 1 -> run `gmgn-cli config`, show the output, and once the user sends the API key run `gmgn-cli config --apply <KEY>` and show that output. If `--check` is an unknown option, tell the user to run `npm install -g gmgn-cli`, then retry.**

**IMPORTANT: Always use the pre-installed `gmgn-cli` binary. Never use web search, WebFetch, curl, `npx`, or gmgn.ai — the site requires login and exposes no structured data.**

**⚠️ IPv6 IS NOT SUPPORTED.** On a `401`/`403` with correct credentials, check `ifconfig | grep inet6` (macOS) or `ip addr show | grep inet6` (Linux) and fetch `https://ipv6.icanhazip.com`. If an IPv6 address comes back, tell the user to disable IPv6 — `gmgn-cli` works over IPv4 only.

What this skill is for, and what it is not

| The user's question | Goes to | |---|---| | "what is hot and worth looking at" — no address given, wants a chosen list | **here** | | "top N by volume / swaps on chain X", "hot coins", "what's pumping", "hot search list" — wants the raw ranking in the exchange's own order | `gmgn-market trending` / `market hot-searches` | | "just launched", "new tokens", bonding-curve stage | `gmgn-market trenches` | | one token address + "safe?" / "score it" | `gmgn-contract-dd` | | a token by name + "should I buy N dollars of it" | `gmgn-token-buy` | | "what is smart money buying" — wallet-side view of the same market | `gmgn-track smartmoney` | | chart shape / trend read on one token | `gmgn-kline-pattern` |

This skill owns exactly one thing: **turning the raw trending feed into a short list somebody can act on.** It never executes a trade and never deep-dives a single name — hand the winners to `gmgn-contract-dd` or `gmgn-token-buy` if the user wants to go further.

Run

Four steps, and Step 3 runs twice: the first run names the rows whose real creation time it needs, Step 3b fetches those, the second run prints the list. Every code block below is run verbatim; only the values in **Parameters** change.

**Step 1 — sweep every chain.** 7 chains x 3 windows = 21 calls, paced.

CHAINS=(sol bsc base eth robinhood arc stable)   # narrow to a subset when the user asks; never add a name
# An array, and iterated as "${CHAINS[@]}". A plain string iterated as `for ch in $CHAINS` works under
# bash and silently does not under zsh, which performs no word splitting on an unquoted expansion: the
# loop runs once with every chain name in one variable, and the whole sweep collapses to a single
# refused call. Verified under zsh, bash and bash --posix -- all seven iterations.
# mktemp -d, not a name anyone can guess. The old /tmp/gmgn-heat-data-$(date +%s) was a second-resolution
# timestamp in a world-writable directory, and heat_rank.py is written into it and then executed: another
# local