gmgn-market

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 query K-line data for a token, browse trending tokens, or view Trenches token lists.

Core Concepts

-

--filter chain defaults - SOL and EVM chains have different default safety filters that are applied automatically when --filter is omitted. Do not assume the same defaults apply across chains:

- SOL: defaults to renounced frozen (mint and freeze authority renounced)

- BSC / Base / ETH (EVM): defaults to not_honeypot verified renounced

- Omitting --filter is NOT the same as "no filter" - the chain defaults are always applied. To use a custom filter set, explicitly specify all desired filter tags.

-

volume vs amount (kline) - Naming is counterintuitive. volume = USD dollar value of trades; amount = token units traded. For a token priced at $0.0002, these differ by 5,000×. Always use volume for "how much USD was traded" and amount for "how many tokens changed hands."

-

rug_ratio - A 0–1 score estimating rug pull likelihood. Values above 0.3 are high-risk. Do not treat as binary - combine with top_10_holder_rate, dev_team_hold_rate, and is_honeypot for a full picture.