GMGN
Read-only GMGN token, wallet, KOL and smart-money reads through Thirdfy provider gmgn. Advisory evidence for memecoin and wallet research.
Category: Market data · signals
GMGN exposes read-only token, wallet and trade-feed data through Thirdfy provider gmgn. Agents call get_gmgn_* on the Thirdfy catalog. These actions do not place trades.
Pair GMGN evidence with Fomo API handle intel, and with a trading venue for execution.
Actions
| Action | Data category | Purpose |
|---|---|---|
get_gmgn_token_info | market_data | Token metadata for a Solana mint or EVM contract |
get_gmgn_token_security | market_data | Token security and risk flags |
get_gmgn_token_pool | market_data | Primary pool for a token |
get_gmgn_token_holders | market_data | Top holders of a token |
get_gmgn_token_traders | market_data | Top traders of a token |
get_gmgn_token_kline | market_data | Token candles (interval, limit) |
get_gmgn_trending | market_data | Trending token rank for a chain |
get_gmgn_trenches | market_data | New launches on a chain |
get_gmgn_hot_searches | market_data | Hot search tokens on a chain |
get_gmgn_kol_trades | signal | Labeled KOL trade feed for a chain |
get_gmgn_smartmoney_trades | signal | Smart-money trade feed for a chain |
get_gmgn_wallet_activity | wallet | Recent trades and transfers of a wallet |
get_gmgn_wallet_stats | wallet | Wallet performance for period 1d, 7d or 30d |
get_gmgn_wallet_token_balance | wallet | One wallet's balance snapshot |
get_gmgn_created_tokens | wallet | Tokens a wallet created |
Every action takes a GMGN chain slug in chain: sol, base, bsc, eth or robinhood. It is not an EVM chainId. Token reads also take address, and wallet reads take wallet_address.
Signals
GMGN reads are in the catalog but do not have a signal manifest yet. They carry no signals[], typed reading or freshness today. Their outputSchema covers the envelope (payload, classification, attribution, chain), and payload is GMGN's raw reply.
The production catalog (api.thirdfy.com) serves dataCategory and outputSchema on every GMGN read.
Treat GMGN output as context for an agent's reasoning. Do not compare its values in a rule until the read is typed and has a manifest.
| Read | Data category |
|---|---|
Every get_gmgn_* action | market_data, signal or wallet |
Credential model
GMGN reads use the same Thirdfy session as other catalog actions. CLI and MCP do not take a GMGN key. Thirdfy credits pay the catalog action.
| Layer | Model |
|---|---|
| CLI / MCP | Thirdfy auth (email OTP or agent API key). |
| Credits | Thirdfy credits on the agent wallet. |
| Execution | None from GMGN. Use a trading venue for swaps. |
Discovery
| Surface | Example |
|---|---|
| MCP | getProviderActions { provider: "gmgn" } |
| CLI | thirdfy-agent run --action get_gmgn_trending --params '{"chain":"sol"}' --provider gmgn --json |
| CLI (wallet) | thirdfy-agent run --action get_gmgn_wallet_stats --params '{"chain":"sol","wallet_address":"<wallet>","period":"7d"}' --provider gmgn --json |
Readiness checklist
- Agent authenticated for discovery and run (email OTP
agent_walletor agent API key per lane). - Strategy treats GMGN output as advisory evidence.
- Check
get_gmgn_token_securitybefore acting on a new token. - Pace manual calls. GMGN rate limits its upstream API.
Execution lanes
GMGN actions are read-only. They do not require delegation binding. Any execute-intent on a trading venue still requires normal preflight and delegation rules.