gmgn-heat-rank

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

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

Three steps. 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 user could pre-create that directory with their own heat_rank.py, and the run would execute theirs.
DATA=$(mktemp -d); cd "$DATA"
for ch in "${CHAINS[@]}"; do
  # A chain name ends up on a command line, so it is checked against the fixed set of names this API
  # has instead of being passed through. A typo, a chain from some other exchange, or a string with
  # spaces or shell metacharacters in it is refused out loud and skipped -- it never becomes arguments
  # to gmgn-cli. Whole names only: a substring test (`case " sol bsc ... " in *" $ch "*`) accepts any
  # run of adjacent names, so `sol bsc` would pass it. Keep this list literal -- reusing $CHAINS here
  # would check the input against itself.
  case $ch in
    sol|bsc|base|eth|robinhood|arc|stable) ;;
    *) echo "refusing unsupported chain name: $ch" >&2; continue;;
  esac
  # Only tags the API actually recognises. An unrecognised tag is not refused -- it is silently
  # ignored, and a filters list containing nothing else turns the server's own default screening
  # OFF, which is worse than sending no filter at all. So the fourth branch sends no --filter and
  # lets those defaults apply; do not invent a tag to fill it. Measured, see `## Known limits`.
  case $ch in
    sol) F=(--filter renounced --filter frozen --filter not_wash_trading);;
    bsc|base|eth) F=(--filter not_honeypot --filter verified --filter renounced);;
    *) F=();;
  esac
  # 24h first, and stop after it when it comes back empty. A candidate has to be present in the
  # 24h window to count at all, so a chain with nothing there cannot produce one whatever its 1h
  # and 6h lists say -- fetching them spends two calls and 2.8s on a guaranteed empty result.
  # Measured on a real sweep: eth, arc and stable were empty in all three windows, so 6 of the 21
  # calls never had a chance. Skipping them changes no listed name. On a day when all seven chains
  # are alive the sweep still costs its full 21 -- this cuts waste, not coverage.
  for iv in 24h 1h 6h; do
    gmgn-cli market trending --chain "$ch" --interval "$iv" --limit 100 \
      --min-marketcap 500000 --min-liquidity 100000 --max-created 7d \
      "${F[@]}" --raw > "${ch}_${iv}.json" 2>"${ch}_${iv}.err"
    sleep 1.4
    if [ "$iv" = 24h ] && ! grep -q '"rank":\[{' "${ch}_24h.json"; then
      echo "no 24h candidate on $ch -- skipping its 1h/6h calls" >&2
      break
    fi
  done
done
echo "$DATA"