gmgn-callout

BEFORE RUNNING ANY COMMAND: Run gmgn-cli config --check. If exit code is 0, proceed normally. If exit code is 1, (1) run gmgn-cli config and show the output to the user; (2) once the user sends the API Key, run gmgn-cli config --apply <KEY> to complete configuration and verification, then show the output to the user. If --check returns an error (unknown option or command not found), tell the user to run npm install -g gmgn-cli to update, then retry.

IMPORTANT: Always use gmgn-cli commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.

IMPORTANT: Do NOT guess field names or values. When a field's meaning is unclear, look it up in the Response Fields sections below before using it.

⚠️ IPv6 NOT SUPPORTED: If you get a 401 or 403 error and credentials look correct, check for IPv6 immediately: (1) list all network interfaces and their IPv6 addresses — run ifconfig | grep inet6 (macOS) or ip addr show | grep inet6 (Linux); (2) send a test request to https://ipv6.icanhazip.com — if the response is an IPv6 address, outbound traffic is going via IPv6. Tell the user immediately: "Please disable IPv6 on your network interface — gmgn-cli commands only work over IPv4."

Use the gmgn-cli tool to read call-out data based on the user's request.

Core Concepts

• Call-out (喊单) — A public "I'm calling this token" post a wallet publishes on GMGN. The platform snapshots the token's price (call_price) and market cap (call_mc) at that moment, then tracks multiplier = current price ÷ call price. A call-out is a statement, not a trade — the caller may or may not hold the token; read current_holding_usd to see whether they still have skin in the game.

• record vs global — record is the wallet dimension: every call-out made on one wallet, over the last 30 days. global is the feed dimension: the newest call-outs across the chains you pass, with filters. There is no per-token call-out list; to check one wallet's calls on one token, use record --token.

• Declaration (宣言) — A paid, pinned call-out. --only-declaration restricts global to these. Payment buys visibility, not quality — never treat a declaration as a stronger signal than a normal call-out by itself.

• multiplier — Ratio, not percent. 2.35 = token is 2.35× its call price (+135%). 0.5 = down 50% since the call.