--- type: "firecrawl-provider" description: "GMGN (gmgn.ai) memecoin terminal data from its anonymous JSON API: trending tokens and new launches per chain, token detail with security and creator statistics, candles, trades, holders, top traders, first buyers and community posts, plus the smart-money wallet leaderboard, wallet statistics and developer launch history. Chains: sol, eth, base, bsc, tron, monad." use_when: "GMGN (gmgn.ai) memecoin terminal data from its anonymous JSON API: trending tokens and new launches per chain, token detail with security and creator statistics, candles, trades, holders, top traders, first buyers and community posts, plus the smart-money wallet leaderboard, wallet statistics and developer launch history. Chains: sol, eth, base, bsc, tron, monad." categories: "Finance" capabilities: 13 credits_per_call: 5 --- # GMGN on Firecrawl Alexandria GMGN (gmgn.ai) memecoin terminal data from its anonymous JSON API: trending tokens and new launches per chain, token detail with security and creator statistics, candles, trades, holders, top traders, first buyers and community posts, plus the smart-money wallet leaderboard, wallet statistics and developer launch history. Chains: sol, eth, base, bsc, tron, monad. - Categories: Finance - Category index: [Finance category](https://firecrawl.dev/alexandria/agents/categories/finance) - Provider key: `gmgn-ai` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/gmgn-ai) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/openapi.json) ## Capabilities - [Community messages](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/community_messages): Public community posts on a token's gmgn.ai page (`GET /api/v1/token/{chain}/{address}/community/messages`), newest first, with the poster's handle, follower count and position in the token. Cursor pagination. - [Dev created tokens](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/dev_created_tokens): Tokens created by a developer wallet (`GET /api/v1/dev_created_tokens/{chain}/{creator_address}`): per-token market cap, liquidity, holders, 1h activity and fees, plus the creator's open/inner counts and all-time-high token. - [New pairs](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/new_pairs): Newly created pairs/launches on one chain from gmgn.ai's New Pair feed (`GET /api/v1/pairs/{chain}/new_pairs/{period}`): pair and token addresses, launchpad, open time, initial liquidity and the token's early market data, newest first. - [Search](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/search): Search gmgn.ai tokens and wallets by name, symbol or address on one chain (`POST /vas/api/v1/search_v4`). Returns the token matches with price, market cap, liquidity and holder counts, plus wallet matches with 7-day PnL. - [Token candles](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_candles): OHLCV candles for a token (`GET /api/v1/token_candles/{chain}/{address}` or `token_mcap_candles` for market-cap candles): newest `limit` candles at the requested resolution, oldest first. - [Token detail](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_detail): Full profile of one or more tokens on a chain (`POST /mrwapi/v1/multi_token_full_info`): identity, supply, holders, liquidity, launchpad and migration data, ATH, security flags, creator statistics and gmgn's trader-type counts. - [Token holders](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_holders): Top holders of a token (`GET /vas/api/v1/token_holders/{chain}/{address}`): balance, share of supply, cost basis, profit, tags and funding source per wallet. Single page of up to 100 rows: the route's `next` cursor is not honoured by any query parameter the web client uses, so there is no continuation. - [Token traders](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_traders): Top traders of a token by profit (`GET /vas/api/v1/token_traders/{chain}/{address}`): the same per-wallet position record as token_holders, ordered by realized/total profit. Single page of up to 100 rows (no continuation, see token_holders). - [Token trades](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_trades): Recent trades of a token, newest first (`GET /vas/api/mul-region/token_trades_v2/{chain}/{address}`): maker wallet and tags, side, amounts, USD value, price and the maker's realized profit. Cursor pagination. - [Top buyers](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/top_buyers): The first 70 buyers of a token and whether they still hold (`GET /api/v1/tokens/top_buyers/{chain}/{address}`): per-wallet status (hold, bought_more, sold_part, sold, transfered) and the aggregate counts. - [Trending tokens](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/trending_tokens): Trending tokens on one chain from gmgn.ai's Trend page (`GET /api/v1/rank/{chain}/swaps/{period}`): price, change, volume, liquidity, market cap, swaps, holders, launchpad, security flags and gmgn's smart-money/sniper/bundler counts, in the site's rank order. - [Wallet profile](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/wallet_profile): Trading statistics for one wallet (`GET /api/v1/wallet_stat/{chain}/{address}/{period}`): PnL, realized/unrealized profit, win rate, token counts by PnL bucket, native balance, tags, funding source and social binding. Not-found when gmgn.ai has no activity for the address. - [Wallet rank](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/wallet_rank): gmgn.ai's smart-money wallet leaderboard for one chain (`GET /api/v1/rank/{chain}/wallets/{period}`): PnL, realized profit, win rate, trade counts, tags and the 7-day daily profit series per wallet. ## 1. Choose this provider when GMGN (gmgn.ai) memecoin terminal data from its anonymous JSON API: trending tokens and new launches per chain, token detail with security and creator statistics, candles, trades, holders, top traders, first buyers and community posts, plus the smart-money wallet leaderboard, wallet statistics and developer launch history. Chains: sol, eth, base, bsc, tron, monad. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "gmgn-ai", "capability": "crypto/community_messages", "options": { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "limit": 3 } } ``` ## 3. Add provider options Use only the options needed for the task: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `continuation` (string): Opaque cursor from a previous call's `next_continuation`; omit for the first page. Example: `next_continuation` - `limit` (number): Messages per page. Example: `20` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "gmgn-ai", capability: "crypto/community_messages", options: { address: "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", chain: "sol", limit: 3, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "gmgn-ai", "capability": "crypto/community_messages", "options": { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "limit": 3 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "gmgn-ai", "capability": "crypto/community_messages", "options": { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "limit": 3 } } }' ``` ### CLI ```sh firecrawl scrape 'gmgn-ai/crypto/community_messages' \ --options '{"address":"9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump","chain":"sol","limit":3}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "gmgn-ai", "capability": "crypto/community_messages", "options": { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "limit": 3 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "gmgn-ai", "capability": "crypto/community_messages", "options": { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "limit": 3 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "count": 2, "messages": [ { "content": "if you don't buy, you can't rich", "created_at": "2026-10-03T06:08:40Z", "display_name": "Gnurt Huynh", "follower_count": 1057, "id": "gmgn_01M40621DCBYHC4V26VRHDRPQ9", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.49054175528966887, "reply_count": 0, "source": "gmgn", "token_balance": 0, "unrealized_profit": 0, "user_twitter_url": "https://x.com/gnurthuynh", "username": "gnurthuynh", "wallet_address": "EZJPHY8mNNtLKApFhrFgUdxcuhz3BpvgLbMwefFstCMR" }, { "content": "fartcoin szn", "created_at": "2026-09-21T05:19:29Z", "display_name": "gout", "follower_count": 59, "id": "gmgn_01M316FBE4DMJCT3K1ADZF839N", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.008565099159888186, "reply_count": 0, "source": "gmgn", "token_balance": 2.080741, "unrealized_profit": 0.03006896411478266, "user_twitter_url": "https://x.com/goutgot", "username": "goutgot", "wallet_address": "7bXnN71eW3hEyww7ViQjgsBWdhCZUL2op3PELApCMtW3" } ], "next_continuation": "eyJjaGFpbl90b2tlbiI6InNvbCM5QkI2TkZFY2pCQ3RuTkxGa28yRnFWUUJxOEhITTEza0N5WWNkUWJncHVtcCIsImNyZWF0ZV90aW1lIjoxNzg5OTY3OTY5NzMyLCJjaGFpbl93YWxsZXQiOiJVc2VyIzg2ODdjYTM4LTA5MjQtNDJiYS05YzI5LWQ0MTIxMjA5Y2MwOCIsInVsaWQiOiIwMU0zMTZGQkU0RE1KQ1QzSzFBRFpGODM5TiJ9", "observed_at_ms": 1791143829755, "source_url": "https://gmgn.ai/sol/token/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "top_message": { "content": "fartcoin szn", "created_at": "2026-09-21T05:19:29Z", "display_name": "gout", "follower_count": 59, "id": "gmgn_01M316FBE4DMJCT3K1ADZF839N", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.008565099159888186, "reply_count": 0, "source": "gmgn", "token_balance": 2.080741, "unrealized_profit": 0.03006896411478266, "user_twitter_url": "https://x.com/goutgot", "username": "goutgot", "wallet_address": "7bXnN71eW3hEyww7ViQjgsBWdhCZUL2op3PELApCMtW3" } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Community messages - Capability: `crypto/community_messages` - Description: Public community posts on a token's gmgn.ai page (`GET /api/v1/token/{chain}/{address}/community/messages`), newest first, with the poster's handle, follower count and position in the token. Cursor pagination. - Instructions: Sentiment and chatter around a token. - Cost: 5 credits per call - Capability file: [Community messages](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/community_messages) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `continuation` (string): Opaque cursor from a previous call's `next_continuation`; omit for the first page. Example: `next_continuation` - `limit` (number): Messages per page. Example: `20` Response schema example: ```json { "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "chain": "sol", "count": 2, "messages": [ { "content": "if you don't buy, you can't rich", "created_at": "2026-10-03T06:08:40Z", "display_name": "Gnurt Huynh", "follower_count": 1057, "id": "gmgn_01M40621DCBYHC4V26VRHDRPQ9", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.49054175528966887, "reply_count": 0, "source": "gmgn", "token_balance": 0, "unrealized_profit": 0, "user_twitter_url": "https://x.com/gnurthuynh", "username": "gnurthuynh", "wallet_address": "EZJPHY8mNNtLKApFhrFgUdxcuhz3BpvgLbMwefFstCMR" }, { "content": "fartcoin szn", "created_at": "2026-09-21T05:19:29Z", "display_name": "gout", "follower_count": 59, "id": "gmgn_01M316FBE4DMJCT3K1ADZF839N", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.008565099159888186, "reply_count": 0, "source": "gmgn", "token_balance": 2.080741, "unrealized_profit": 0.03006896411478266, "user_twitter_url": "https://x.com/goutgot", "username": "goutgot", "wallet_address": "7bXnN71eW3hEyww7ViQjgsBWdhCZUL2op3PELApCMtW3" } ], "next_continuation": "eyJjaGFpbl90b2tlbiI6InNvbCM5QkI2TkZFY2pCQ3RuTkxGa28yRnFWUUJxOEhITTEza0N5WWNkUWJncHVtcCIsImNyZWF0ZV90aW1lIjoxNzg5OTY3OTY5NzMyLCJjaGFpbl93YWxsZXQiOiJVc2VyIzg2ODdjYTM4LTA5MjQtNDJiYS05YzI5LWQ0MTIxMjA5Y2MwOCIsInVsaWQiOiIwMU0zMTZGQkU0RE1KQ1QzSzFBRFpGODM5TiJ9", "observed_at_ms": 1791143829755, "source_url": "https://gmgn.ai/sol/token/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", "top_message": { "content": "fartcoin szn", "created_at": "2026-09-21T05:19:29Z", "display_name": "gout", "follower_count": 59, "id": "gmgn_01M316FBE4DMJCT3K1ADZF839N", "is_blue_verified": false, "is_kol": false, "like_count": 0, "media_url": null, "realized_profit": -0.008565099159888186, "reply_count": 0, "source": "gmgn", "token_balance": 2.080741, "unrealized_profit": 0.03006896411478266, "user_twitter_url": "https://x.com/goutgot", "username": "goutgot", "wallet_address": "7bXnN71eW3hEyww7ViQjgsBWdhCZUL2op3PELApCMtW3" } } ``` ### Dev created tokens - Capability: `crypto/dev_created_tokens` - Description: Tokens created by a developer wallet (`GET /api/v1/dev_created_tokens/{chain}/{creator_address}`): per-token market cap, liquidity, holders, 1h activity and fees, plus the creator's open/inner counts and all-time-high token. - Instructions: Developer history: what else a token's creator (token_detail.creator_address) has launched. - Cost: 5 credits per call - Capability file: [Dev created tokens](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/dev_created_tokens) Accepted options: - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `creator_address` (string, required): Wallet address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `` - `limit` (number): Maximum tokens returned. Example: `50` Response schema example: ```json { "ath_token": { "address": "F5WvFdG9sCfhv3bVYAMJNWiwpx5e3X2uvpXDtLtdsDJs", "market_cap": 2153524.3, "name": "Ash Ketchum", "symbol": "Ash" }, "chain": "sol", "count": 3, "creator_address": "G8xsXadFYDrjqxbzaj7TXFsAzKPEuY6gXy9sDcf3DkR1", "inner_count": 10, "last_create_timestamp": 1791129995, "observed_at_ms": 1791143875858, "open_count": 6, "open_ratio": 0.375, "source_url": "https://gmgn.ai/sol/address/G8xsXadFYDrjqxbzaj7TXFsAzKPEuY6gXy9sDcf3DkR1", "tokens": [ { "address": "6jCmgFinCp3NHDyjzVAFdco5AEFSR8EZda2ozAWAVkTP", "ath_market_cap": 92228.101, "biggest_pool": "9VbXjaYvZ9jkTa8MNwWayrLzWT2vhfEombEGRNm3QTeN", "bundler_rate": 0.0297, "chain": "sol", "create_timestamp": 1791129995, "cto_flag": true, "holders": 191, "is_open": true, "is_pump": true, "launchpad_platform": "Pump.fun", "logo": "https://gmgn.ai/external-res/aa94f6802816e443251e8b119c75fa71_v2.webp", "market_cap": 3965.306397958841, "pool_liquidity": 1821.59886559232, "source_url": "https://gmgn.ai/sol/token/6jCmgFinCp3NHDyjzVAFdco5AEFSR8EZda2ozAWAVkTP", "swap_1h": 11, "symbol": "CEO", "total_fee": 15.028878371169611, "volume_1h": 75.27638346 }, { "address": "F5WvFdG9sCfhv3bVYAMJNWiwpx5e3X2uvpXDtLtdsDJs", "ath_market_cap": 2153524.3, "biggest_pool": "6e4wZ83xEmcj3LP9JNwzncW2hu3qXDEKLQUw3G6LKT8U", "bundler_rate": 0.026, "chain": "sol", "create_timestamp": 1791127416, "cto_flag": true, "holders": 3681, "is_open": true, "is_pump": true, "launchpad_platform": "Pump.fun", "logo": "https://gmgn.ai/external-res/04bfd3506179ab3337e935942bf69de2_v2.webp", "market_cap": 682577.4478278134, "pool_liquidity": 84493.71462769312, "source_url": "https://gmgn.ai/sol/token/F5WvFdG9sCfhv3bVYAMJNWiwpx5e3X2uvpXDtLtdsDJs", "swap_1h": 3602, "symbol": "Ash", "total_fee": 213.5064371423546, "volume_1h": 299506.74311978 }, { "address": "Fnrox8rZrSCwPmkSwh2MKBZwhHdj2YdYJX733FUReoKs", "ath_market_cap": 51275.605, "biggest_pool": "DUVbjNheAffULmtGAvDMk8rC5FShnMockiTuEbjnXerM", "bundler_rate": 0, "chain": "sol", "create_timestamp": 1791093574, "cto_flag": false, "holders": 87, "is_open": true, "is_pump": true, "launchpad_platform": "Pump.fun", "logo": "https://gmgn.ai/external-res/b7de7b5c207b5334cbb07e2d00836a51_v2.webp", "market_cap": 2370.6559378451807, "pool_liquidity": 376.51911792448, "source_url": "https://gmgn.ai/sol/token/Fnrox8rZrSCwPmkSwh2MKBZwhHdj2YdYJX733FUReoKs", "swap_1h": 0, "symbol": "POST", "total_fee": 5.374933448674185, "volume_1h": 0 } ], "total_count": 16 } ``` ### New pairs - Capability: `crypto/new_pairs` - Description: Newly created pairs/launches on one chain from gmgn.ai's New Pair feed (`GET /api/v1/pairs/{chain}/new_pairs/{period}`): pair and token addresses, launchpad, open time, initial liquidity and the token's early market data, newest first. - Instructions: Discover tokens launched in the last minutes or hours. Snapshot listing (no pagination). - Cost: 5 credits per call - Capability file: [New pairs](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/new_pairs) Accepted options: - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `exclude_honeypots` (boolean): Apply the site's not_honeypot filter. Example: `false` - `limit` (number): Maximum pairs. Example: `20` - `period` (string): Look-back window. Example: `1h` Response schema example: ```json { "chain": "sol", "count": 3, "observed_at_ms": 1791143713979, "pairs": [ { "base_address": "BDr6KyfFM8fip9geQksrvq2BtF6P2h97hXWhQANypump", "base_token": { "address": "BDr6KyfFM8fip9geQksrvq2BtF6P2h97hXWhQANypump", "burn_ratio": 1, "burn_status": "burn", "creation_timestamp": 1791143711, "creator": "9g9kLGkhFiM7YmbTMogRREPQV4KYSppeqX5s9eyqF2fM", "is_honeypot": false, "launchpad_status": 0, "liquidity": 0, "logo": "https://gmgn.ai/external-res/0d15d74bef6a13318205e280e6bff5fe_v2.webp", "market_cap": 0, "name": "beenetwork", "price": 0, "price_change_percent_1h": 0, "progress": 0, "renounced_freeze_account": true, "renounced_mint": true, "social_links": {}, "symbol": "BEE", "total_supply": 1000000000, "volume": 0 }, "chain": "sol", "exchange": "pump", "initial_liquidity": 0.22, "launchpad": "pump", "launchpad_platform": "Pump.fun", "open_timestamp": 1791143711, "pair_address": "6TfxuMQmUt5S7M6mycXE5pgwUMnrjbNxoCN26diPfPTx", "quote_address": "So11111111111111111111111111111111111111112", "quote_reserve_usd": 0, "quote_symbol": "SOL", "source_url": "https://gmgn.ai/sol/token/BDr6KyfFM8fip9geQksrvq2BtF6P2h97hXWhQANypump" }, { "base_address": "5VMwAPXDXDTYSu4YEyFU8P3Sce3FqLfxMJAh5Y6w8t8m", "base_token": { "address": "5VMwAPXDXDTYSu4YEyFU8P3Sce3FqLfxMJAh5Y6w8t8m", "burn_ratio": 1, "burn_status": "burn", "creation_timestamp": 1791143711, "creator": "3zoJQwChhkWkRbTxUN7G5SaAwpYDCH3xdRYJDYdtU6E9", "is_honeypot": false, "launchpad_status": 0, "liquidity": 0, "logo": null, "market_cap": 0, "name": "Sway Swap", "price": 0, "price_change_percent_1h": 0, "progress": 0, "renounced_freeze_account": true, "renounced_mint": true, "social_links": { "twitter_username": "useSwaySwap", "website": "https://swayswap.wtf/" }, "symbol": "SWAY", "total_supply": 1000000000, "volume": 0 }, "chain": "sol", "exchange": "pump", "initial_liquidity": 0.22, "launchpad": "pump", "launchpad_platform": "Pump.fun", "open_timestamp": 1791143711, "pair_address": "8isCGoFDPaFZ2mNgaAP8LemvC1rxaFpEMT47K74Taho3", "quote_address": "So11111111111111111111111111111111111111112", "quote_reserve_usd": 0, "quote_symbol": "SOL", "source_url": "https://gmgn.ai/sol/token/5VMwAPXDXDTYSu4YEyFU8P3Sce3FqLfxMJAh5Y6w8t8m" }, { "base_address": "tohj4HLjZ5vZimvZNw6P56wBLJdCunjWH2uzsg6sf7k", "base_token": { "address": "tohj4HLjZ5vZimvZNw6P56wBLJdCunjWH2uzsg6sf7k", "burn_ratio": 1, "burn_status": "burn", "creation_timestamp": 1791143710, "creator": "6ATnpbwa43DtscAWjiR3uh5bEfpc4mhFpF42F5a5f68T", "is_honeypot": false, "launchpad_status": 0, "liquidity": 0, "logo": null, "market_cap": 0, "name": "I don't want to", "price": 0, "price_change_percent_1h": 0, "progress": 0, "renounced_freeze_account": true, "renounced_mint": true, "social_links": {}, "symbol": "TRADE", "total_supply": 1000000000, "volume": 0 }, "chain": "sol", "exchange": "pump", "initial_liquidity": 0.19, "launchpad": "pump", "launchpad_platform": "pump_mayhem", "open_timestamp": 1791143710, "pair_address": "5s8wjPzJABwsn4aBUaEH15FRLmfpFLXm7QikQ8YmTnzm", "quote_address": "So11111111111111111111111111111111111111112", "quote_reserve_usd": 0, "quote_symbol": "SOL", "source_url": "https://gmgn.ai/sol/token/tohj4HLjZ5vZimvZNw6P56wBLJdCunjWH2uzsg6sf7k" } ], "period": "1h" } ``` ### Search - Capability: `crypto/search` - Description: Search gmgn.ai tokens and wallets by name, symbol or address on one chain (`POST /vas/api/v1/search_v4`). Returns the token matches with price, market cap, liquidity and holder counts, plus wallet matches with 7-day PnL. - Instructions: Find a token's address from its name or ticker before calling token_detail, token_trades or token_holders; or find tracked wallets by Twitter handle. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/search) Accepted options: - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `include_wallets` (boolean): Also return wallet matches. Example: `false` - `limit` (number): Maximum tokens (and wallets) to return; the site returns up to about 60 of each. Example: `20` - `query` (string, required): Name, symbol or address fragment. Example: `` Response schema example: ```json { "chain": "sol", "observed_at_ms": 1791143563726, "query": "samo", "token_count": 3, "tokens": [ { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "ath_market_cap": 30704248.4072, "chain": "sol", "created_at": 1618951432, "creator": null, "exchange": "ray_v2", "holder_count": 33836, "hot_level": 0, "is_honeypot": false, "kol_count": 7, "launchpad": null, "launchpad_platform": "pool_ray", "liquidity": 62160.418022, "logo": "https://gmgn.ai/external-res/b44c5a2dda718ad61ce1bc000228bb9a_v2.webp", "market_cap": 2019459.835224969, "name": "Samoyed Coin", "price": 0.00035205226, "renounced_freeze_account": true, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "swaps_1h": 32, "swaps_24h": 0, "symbol": "SAMO", "telegram": "https://t.me/samoyedcoin", "twitter_username": "https://x.com/samoyedcoin", "volume_1h": 271, "volume_24h": 0, "website": "https://samoyedcoin.com/" }, { "address": "76KZTZuCSzPnB6EHxSdisraMmqZeLzF2NKFCGqYBry1Q", "ath_market_cap": 7534.0759, "chain": "sol", "created_at": 1791059655, "creator": "CALQ1EwjARtaW6FW6KQDZj4jhye9Vt4NvTzFwmg4JHqC", "exchange": "pump", "holder_count": 1, "hot_level": 0, "is_honeypot": false, "kol_count": 0, "launchpad": "pump", "launchpad_platform": "Pump.fun", "liquidity": 7178.739141, "logo": "https://gmgn.ai/external-res/27a3273480c15f41aa4cf2bdcaa8dd16_v2.webp", "market_cap": 3345.7555, "name": "Free Samourai", "price": 0.0000033457555, "renounced_freeze_account": true, "source_url": "https://gmgn.ai/sol/token/76KZTZuCSzPnB6EHxSdisraMmqZeLzF2NKFCGqYBry1Q", "swaps_1h": 0, "swaps_24h": 0, "symbol": "Samourai", "telegram": null, "twitter_username": "https://x.com/leamuirleyn/status/2106482965882733002", "volume_1h": 0, "volume_24h": 0, "website": "https://usepaid.app/token/76KZTZuCSzPnB6EHxSdisraMmqZeLzF2NKFCGqYBry1Q" }, { "address": "HWcMSbzxEBtQj69hkJRhafzEC4P6Q1dhFsq43QXLVAkh", "ath_market_cap": 5766.6401, "chain": "sol", "created_at": 1788813348, "creator": "HMtLswKnCbtf3UgvZEYQqkRuvShFyVNq8HvcDA4L4uG4", "exchange": "ray_launchpad", "holder_count": 2, "hot_level": 0, "is_honeypot": false, "kol_count": 0, "launchpad": "ray_launchpad", "launchpad_platform": "stonkfun", "liquidity": 4662.810737, "logo": "https://gmgn.ai/external-res/025b05bd5065ef56ef7d244a3ffc52b0_v2.webp", "market_cap": 4649.815, "name": "Samoyedcoin", "price": 0.000004649815, "renounced_freeze_account": true, "source_url": "https://gmgn.ai/sol/token/HWcMSbzxEBtQj69hkJRhafzEC4P6Q1dhFsq43QXLVAkh", "swaps_1h": 0, "swaps_24h": 0, "symbol": "SAMO", "telegram": null, "twitter_username": "https://x.com/pvysol/status/2097061120590651894?s=20", "volume_1h": 0, "volume_24h": 0, "website": "https://www.stonkfun.xyz/" } ], "wallet_count": 3, "wallets": [ { "address": "AJEMVdrw4p8uPgVPEbDq8rsYXcnao43U8STRa4nNqrDP", "balance": 0.976035565, "chain": "sol", "ens": null, "follow_count": 0, "fund_from": "Binance", "fund_from_ts": 1739983713, "last_active_time": 1779813050, "pnl_7d": -0.0459983070155115, "realized_profit_7d": -2.08999000914, "remark_count": 1, "source_url": "https://gmgn.ai/sol/address/AJEMVdrw4p8uPgVPEbDq8rsYXcnao43U8STRa4nNqrDP", "tags": [ "gmgn" ], "twitter_name": "SM 🐶", "twitter_username": "samoyed_cutedog", "win_rate_7d": 0 }, { "address": "vonvuBhb56gc6XejEoZBgjzvDupk4vzMe7956WJuA2e", "balance": 0.388895926, "chain": "sol", "ens": null, "follow_count": 0, "fund_from": null, "fund_from_ts": 1741515920, "last_active_time": 1789815494, "pnl_7d": null, "realized_profit_7d": 0, "remark_count": 0, "source_url": "https://gmgn.ai/sol/address/vonvuBhb56gc6XejEoZBgjzvDupk4vzMe7956WJuA2e", "tags": [], "twitter_name": "Samoris.trust", "twitter_username": "Samoris4", "win_rate_7d": 0 }, { "address": "HfAFUarYwxpkT5LpAK8rM1SUykqY8mTB232nD5K9TbRG", "balance": 0.002969157, "chain": "sol", "ens": null, "follow_count": 1, "fund_from": null, "fund_from_ts": 1739732694, "last_active_time": 1739795788, "pnl_7d": null, "realized_profit_7d": 0, "remark_count": 0, "source_url": "https://gmgn.ai/sol/address/HfAFUarYwxpkT5LpAK8rM1SUykqY8mTB232nD5K9TbRG", "tags": [ "gmgn", "gmgn_go" ], "twitter_name": "Samo Deki", "twitter_username": "SDeki1", "win_rate_7d": 0 } ] } ``` ### Token candles - Capability: `crypto/token_candles` - Description: OHLCV candles for a token (`GET /api/v1/token_candles/{chain}/{address}` or `token_mcap_candles` for market-cap candles): newest `limit` candles at the requested resolution, oldest first. - Instructions: Price or market-cap history of a token at 1s to 1d resolution. - Cost: 5 credits per call - Capability file: [Token candles](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_candles) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `limit` (number): Number of candles. Example: `100` - `metric` (string): price: USD price candles; market_cap: USD market-cap candles. Example: `price` - `resolution` (string): resolution Example: `1m` Response schema example: ```json { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "candles": [ { "amount": 1217661.65131822, "close": 0.00033889503, "high": 0.0003397415, "low": 0.00033714857, "open": 0.0003373264, "time_ms": 1791126000000, "volume": 412.73361314 }, { "amount": 3097682.55596224, "close": 0.00035227521, "high": 0.00035264905, "low": 0.00033842652, "open": 0.00033889503, "time_ms": 1791129600000, "volume": 1076.59440476 }, { "amount": 1377760.4509293993, "close": 0.00035401341, "high": 0.00035442196, "low": 0.00034980359, "open": 0.00035227521, "time_ms": 1791133200000, "volume": 485.55328894 }, { "amount": 93209.60679095, "close": 0.00035208619, "high": 0.00035401341, "low": 0.00035169891, "open": 0.00035401341, "time_ms": 1791136800000, "volume": 32.84252447 }, { "amount": 771471.20528236, "close": 0.0003514363, "high": 0.00035454485, "low": 0.0003514363, "open": 0.00035208619, "time_ms": 1791140400000, "volume": 272.53871999 } ], "chain": "sol", "count": 5, "metric": "price", "observed_at_ms": 1791143745743, "resolution": "1h", "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" } ``` ### Token detail - Capability: `crypto/token_detail` - Description: Full profile of one or more tokens on a chain (`POST /mrwapi/v1/multi_token_full_info`): identity, supply, holders, liquidity, launchpad and migration data, ATH, security flags, creator statistics and gmgn's trader-type counts. - Instructions: Details for a token address from search, trending_tokens or new_pairs, or a pasted gmgn.ai token page URL. Up to 20 addresses per call. - Cost: 5 credits per call - Capability file: [Token detail](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_detail) Accepted options: - `address` (string): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `addresses` (string[]): Batch alternative to `address`. Example: `[]` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `url` (string): Alternative to chain+address: a gmgn.ai token page URL such as https://gmgn.ai/sol/token/
. Pattern: ^https?://(www\.)?gmgn\.ai/. Example: `` Response schema example: ```json { "chain": "sol", "count": 1, "observed_at_ms": 1791143548058, "tokens": [ { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "ath_market_cap": 30704248.4072, "ath_price": 0.0053524748999839, "ath_timestamp": 1747008000, "banner": null, "biggest_pool_address": "EyDgEU9BdG7m6ZK4bYERxbN4NCJ129WzPtv23dBkfsLg", "bot_degen_rate": 0.0019, "chain": "sol", "creation_timestamp": 1618951432, "creator_address": null, "creator_hold_rate": 0, "creator_stat": null, "creator_token_status": "creator_close", "decimals": 9, "dev_team_hold_rate": 0, "fresh_wallet_rate": 0.0012, "holder_count": 33836, "launch_quote_address": null, "launchpad": null, "launchpad_platform": "pool_ray", "launchpad_progress": 1, "launchpad_status": 1, "links": { "description": null, "discord": null, "geckoterminal": "https://www.geckoterminal.com/solana/tokens/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "gmgn": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "telegram": "https://t.me/samoyedcoin", "twitter_username": "samoyedcoin", "website": "https://samoyedcoin.com/" }, "liquidity": 62160.41802243095, "logo": "https://gmgn.ai/external-res/b44c5a2dda718ad61ce1bc000228bb9a_v2.webp", "migrated_pool_exchange": null, "migrated_timestamp": 0, "name": "Samoyed Coin", "open_timestamp": null, "rug_ratio": 0.172414, "security": { "burn_ratio": 0, "burn_status": "none", "buy_tax": 0, "flags": [], "is_blacklist": null, "is_honeypot": null, "is_locked": false, "is_open_source": null, "is_renounced": null, "is_show_alert": false, "lock_percent": 0, "renounced_freeze_account": true, "renounced_mint": true, "sell_tax": 0, "top_10_holder_rate": 0.2867 }, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "standard": null, "symbol": "SAMO", "top_10_holder_rate": 0.2867, "total_supply": 5736250167.02057, "trade_stat": { "bundler_wallets": 475, "fresh_wallets": 744, "rat_trader_wallets": 25, "renowned_wallets": 7, "smart_wallets": 10, "sniper_wallets": 911, "top_wallets": 6, "updated_at": 1791133061156, "whale_wallets": 42 }, "visiting_count": null } ] } ``` ### Token holders - Capability: `crypto/token_holders` - Description: Top holders of a token (`GET /vas/api/v1/token_holders/{chain}/{address}`): balance, share of supply, cost basis, profit, tags and funding source per wallet. Single page of up to 100 rows: the route's `next` cursor is not honoured by any query parameter the web client uses, so there is no continuation. - Instructions: Holder concentration and who holds a token. - Cost: 5 credits per call - Capability file: [Token holders](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_holders) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `direction` (string): direction Example: `desc` - `limit` (number): Holders to return (1-100). Example: `20` - `sort_by` (string): Server-side order; the site rejects other columns (usd_value, cost) with 400. Example: `amount_percentage` Response schema example: ```json { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "chain": "sol", "count": 3, "holders": [ { "account_address": "ChdRKwt6VPVTum6mnu7KW7FipTuiM1RSYNtrV1oXRdcV", "address": "SamotoLyMemeKovenkooooooooooooooooooooooooo", "amount_percentage": 0.12203095513639624, "avg_cost": null, "avg_sold": null, "balance": 700000086.7828326, "buy_tx_count": 0, "buy_volume": 0, "cost": 2.86462572975e-9, "end_holding_at": null, "is_new": false, "is_on_curve": true, "is_suspicious": false, "last_active_timestamp": 1771920577, "maker_token_tags": [ "top_holder", "transfer_in" ], "name": null, "native_transfer": { "amount": null, "from_address": null, "name": null, "timestamp": 0 }, "netflow_usd": 0, "profit": -7.296502072499998e-10, "profit_change": -0.2547104844002352, "realized_profit": 0, "sell_tx_count": 0, "sell_volume": 0, "source_url": "https://gmgn.ai/sol/address/SamotoLyMemeKovenkooooooooooooooooooooooooo", "start_holding_at": null, "tags": [], "twitter_username": null, "unrealized_profit": -7.296502072499998e-10, "usd_value": 246005.4404986376, "wallet_tag": "TOP1" }, { "account_address": "81m8jgZCST4nSrsAmVPVPyEex3aJTrtGNxvmUH274JAW", "address": "EFE3j1pcSP1paUzA86zW7989ZjsFP2J7ginyUqo4ewqR", "amount_percentage": 0.05114628898150894, "avg_cost": null, "avg_sold": null, "balance": 293387908.712663, "buy_tx_count": 0, "buy_volume": 0, "cost": 284152.3159461883, "end_holding_at": null, "is_new": false, "is_on_curve": true, "is_suspicious": false, "last_active_timestamp": 1790942530, "maker_token_tags": [ "top_holder", "transfer_in" ], "name": null, "native_transfer": { "amount": 3838.00720434, "from_address": "6LY1JzAFVZsP2a2xKrtU6znQMQ5h4i7tocWdgrkZzkzF", "name": null, "timestamp": 1777291286 }, "netflow_usd": 0, "profit": -255816.97384659183, "profit_change": -0.5983206124302901, "realized_profit": -74771.81900311963, "sell_tx_count": 0, "sell_volume": 0, "source_url": "https://gmgn.ai/sol/address/EFE3j1pcSP1paUzA86zW7989ZjsFP2J7ginyUqo4ewqR", "start_holding_at": 1758572477, "tags": [ "bluechip_owner" ], "twitter_username": null, "unrealized_profit": -181045.15484347224, "usd_value": 103107.16110271604, "wallet_tag": "TOP2" }, { "account_address": "E7ywW5TcnvwWWXXw1a18T59s2z4vUrGSKurGeSEAdJ7V", "address": "BurnAirdropSamooooooooooooooooooooooooooooon", "amount_percentage": 0.050517322564841406, "avg_cost": null, "avg_sold": null, "balance": 289780000.0000035, "buy_tx_count": 0, "buy_volume": 0, "cost": 0, "end_holding_at": null, "is_new": false, "is_on_curve": false, "is_suspicious": false, "last_active_timestamp": 1748056635, "maker_token_tags": [ "top_holder", "transfer_in" ], "name": null, "native_transfer": null, "netflow_usd": 0, "profit": 0, "profit_change": null, "realized_profit": 0, "sell_tx_count": 0, "sell_volume": 0, "source_url": "https://gmgn.ai/sol/address/BurnAirdropSamooooooooooooooooooooooooooooon", "start_holding_at": null, "tags": [], "twitter_username": null, "unrealized_profit": 0, "usd_value": 101839.21101400124, "wallet_tag": "TOP3" } ], "observed_at_ms": 1791143777225, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" } ``` ### Token traders - Capability: `crypto/token_traders` - Description: Top traders of a token by profit (`GET /vas/api/v1/token_traders/{chain}/{address}`): the same per-wallet position record as token_holders, ordered by realized/total profit. Single page of up to 100 rows (no continuation, see token_holders). - Instructions: Who made (or lost) the most on a token. - Cost: 5 credits per call - Capability file: [Token traders](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_traders) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `direction` (string): direction Example: `desc` - `limit` (number): Traders to return (1-100). Example: `20` - `sort_by` (string): Server-side order; values verified against the site. Example: `profit` Response schema example: ```json { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "chain": "sol", "count": 2, "observed_at_ms": 1791143794905, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "traders": [ { "account_address": "7EhxFU5ScFZMvBtyAXqB4ariEHqtgo5u1W7ye74boHsZ", "address": "5AJhHJLsuXwfGRMRrAPJzPSrNxkCzsMXuvmbJPfuY1ob", "amount_percentage": 3.419481268925917e-15, "avg_cost": 0.007617898050915383, "avg_sold": 0.009689391571376969, "balance": 0.000019615, "buy_tx_count": 2, "buy_volume": 40548.016705, "cost": 0, "end_holding_at": null, "is_new": false, "is_on_curve": true, "is_suspicious": false, "last_active_timestamp": 1732985058, "maker_token_tags": [ "whale", "transfer_in" ], "name": null, "native_transfer": { "amount": 172.397422, "from_address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9", "name": "Binance", "timestamp": 1735816128 }, "netflow_usd": -63444.149322455894, "profit": 11700.174648991784, "profit_change": 0.12677345535879253, "realized_profit": 11700.174648991784, "sell_tx_count": 33, "sell_volume": 103992.1660274559, "source_url": "https://gmgn.ai/sol/address/5AJhHJLsuXwfGRMRrAPJzPSrNxkCzsMXuvmbJPfuY1ob", "start_holding_at": 1729100684, "tags": [], "twitter_username": null, "unrealized_profit": 0, "usd_value": 6.8934230245e-9, "wallet_tag": "TOP2" }, { "account_address": "8TewBi9i13c2EWs2PbYLMFNXz47s82RFVcgrgSN1si27", "address": "64J9nJcoNtMa6n4EYPHai1U9HhTe9SteDuxfhhLLdMvC", "amount_percentage": 0, "avg_cost": 0.007438988699816267, "avg_sold": 0.011247955570887667, "balance": 0, "buy_tx_count": 5, "buy_volume": 15615.837061766864, "cost": 0, "end_holding_at": null, "is_new": false, "is_on_curve": true, "is_suspicious": false, "last_active_timestamp": 1718390291, "maker_token_tags": [ "transfer_in" ], "name": null, "native_transfer": { "amount": 0.01955952, "from_address": "AWQTtpixH74RpAJtxFJvaPJErkN5s9CRYTdvPxqmjtZR", "name": null, "timestamp": 1737562293 }, "netflow_usd": -28492.581694412045, "profit": 9741.301074471989, "profit_change": 0.28344829975826374, "realized_profit": 9741.301074471989, "sell_tx_count": 7, "sell_volume": 44108.41875617891, "source_url": "https://gmgn.ai/sol/address/64J9nJcoNtMa6n4EYPHai1U9HhTe9SteDuxfhhLLdMvC", "start_holding_at": null, "tags": [], "twitter_username": null, "unrealized_profit": 0, "usd_value": 0, "wallet_tag": "TOP5" } ] } ``` ### Token trades - Capability: `crypto/token_trades` - Description: Recent trades of a token, newest first (`GET /vas/api/mul-region/token_trades_v2/{chain}/{address}`): maker wallet and tags, side, amounts, USD value, price and the maker's realized profit. Cursor pagination. - Instructions: Trading activity and signals for a token: who is buying and selling, in what size. - Cost: 5 credits per call - Capability file: [Token trades](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/token_trades) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `continuation` (string): Opaque cursor from a previous call's `next_continuation`; omit for the first page. Example: `next_continuation` - `limit` (number): Trades per page (the site serves 50 per request; smaller pages continue from the last trade returned). Example: `50` Response schema example: ```json { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "chain": "sol", "count": 3, "next_continuation": "NDUzMzU1MjUzMDA0ODYwMjg=", "observed_at_ms": 1791143764443, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "trades": [ { "amount_usd": 0.540885, "balance": 1.59884126, "base_amount": 1536.389106409, "event": "sell", "gas_usd": 0.00020357875, "id": "NDUzMzU2MTM0MDA0NTMwNTI=", "is_open_or_close": 0, "maker": "GxDC9e7SP9mzhDo4re5HbpLa2RW7gB9DtmThx4i4pXSq", "maker_name": null, "maker_tags": [ "sandwich_bot", "bluechip_owner" ], "maker_token_tags": [ "sniper", "bundler" ], "maker_twitter_username": null, "price_usd": 0.00035204948911946515, "quote_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "quote_amount": 0.540885, "quote_symbol": null, "realized_profit": 177.22677218552118, "timestamp": 1791143634, "total_trade": 4968, "tx_hash": "5w78E9jXtodH1RKp8QXXYsLNMAYktK62rDDXyAzdkoVayY1fiFTHAwVqGwuLbk683FBZTcmk9vzofudrr6jmq2Gz", "unrealized_profit": 0 }, { "amount_usd": 0.5399429048036833, "balance": 1.59884126, "base_amount": 1536.389106409, "event": "buy", "gas_usd": 0.00020357875, "id": "NDUzMzU2MTM0MDA0NTMwMzY=", "is_open_or_close": 0, "maker": "GxDC9e7SP9mzhDo4re5HbpLa2RW7gB9DtmThx4i4pXSq", "maker_name": null, "maker_tags": [ "sandwich_bot", "bluechip_owner" ], "maker_token_tags": [ "sniper", "bundler" ], "maker_twitter_username": null, "price_usd": 0.00035143630122820324, "quote_address": "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R", "quote_amount": 0.253847, "quote_symbol": null, "realized_profit": 177.22677218552118, "timestamp": 1791143634, "total_trade": 4968, "tx_hash": "5w78E9jXtodH1RKp8QXXYsLNMAYktK62rDDXyAzdkoVayY1fiFTHAwVqGwuLbk683FBZTcmk9vzofudrr6jmq2Gz", "unrealized_profit": 0 }, { "amount_usd": 0.852314, "balance": 0, "base_amount": 2421.080920065, "event": "sell", "gas_usd": 0.00036423, "id": "NDUzMzU1MjUzMDA0ODYwMjg=", "is_open_or_close": 0, "maker": "78Bo7xxGWBEvqbh3VMKvkFG4Z63cXKSJ2LCEXAanhN7a", "maker_name": null, "maker_tags": [ "sandwich_bot", "bluechip_owner" ], "maker_token_tags": [ "sniper", "bundler" ], "maker_twitter_username": null, "price_usd": 0.0003520386257792315, "quote_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "quote_amount": 0.852314, "quote_symbol": null, "realized_profit": 28.291728439261114, "timestamp": 1791143397, "total_trade": 8083, "tx_hash": "3mMJHghN8k91fmn7XcbuFrht1ipdVn3d9WvYdkxKJ8Wx4zBMNgRuqGQc5BjbzgsKgNeNFTBxPvXUns2ETWpEifye", "unrealized_profit": 0 } ] } ``` ### Top buyers - Capability: `crypto/top_buyers` - Description: The first 70 buyers of a token and whether they still hold (`GET /api/v1/tokens/top_buyers/{chain}/{address}`): per-wallet status (hold, bought_more, sold_part, sold, transfered) and the aggregate counts. - Instructions: Sniper/early-buyer analysis for a token. - Cost: 5 credits per call - Capability file: [Top buyers](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/top_buyers) Accepted options: - `address` (string, required): Token contract/mint address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` Response schema example: ```json { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "buyer_count": 66, "buyers": [ { "maker_token_tags": [ "sniper" ], "status": null, "tags": [], "wallet_address": "DqNW9XsVNoQZYGXgXEdTQ3D2zzCfgFEjyRHHLkWf67va" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "Ft6fZtTtL5EJANevdXwcSvD4Lum8QMTMepF9zjvFPh2X" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "gmgn", "bluechip_owner" ], "wallet_address": "CatyeC3LgBxub7HcpW2n7cZZZ66CUKdcZ8DzHucHrSiP" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "HvFdDWS3RqymRAVx1ZdoL2RjiC38r5dtt19Z8op5jqDK" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "7dGrdJRYtsNR8UYxZ3TnifXGjGc9eRYLq9sELwYpuuUu" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot" ], "wallet_address": "A3vFkGBrj4MRugemEXWdSFztWgBXi9eQPtD3V28Va7WH" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "GoGoGo6N99mpyB7rfzhw2R4fXmaFctURXHaHMoGCyoLD" }, { "maker_token_tags": [ "sniper" ], "status": "bought_more", "tags": [], "wallet_address": "2NXEsxWGmFJxhQCF5wk1SPGj9nXKCPpWV8zjw2gGLALe" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "FdoTysnwd7GfxPoQAyt7TNKf5k7xchm5hpmzKi62sfQJ" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "CTjCZnRXbKAbRQJTb37epqAQiXZcj6y8M4PFZcu9Y28M" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "888BMMsC1CPmVnnK4HLnKjXb7ZKUKpdCXiwqMvCQqVmo" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "GHigB15jr7wZ8GitjD4Hf5naqyUJfMbKa1n1PmSiBhUc" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "5G7Xh1UyrPJSpNyAHqxQJgCGAMHadaveF6fyrcjmo7rJ" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "56YM95f3yAmNbVxHRfho1MAx78GBL1fTjQGwaMDYVmNm" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "AkCyNQ7vxJeQRXx94VkM5xdcDz6KvhyvZSjk7Ztu85qq" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [], "wallet_address": "691hAoXKv5fD4PKgxAWb4Cyg12zc3ns9pnGbWLqH1dxc" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "b619EzHShebQRX7oouwUD5fUo72ai8GgcMLAHkcqfG2" }, { "maker_token_tags": [ "sniper" ], "status": "bought_more", "tags": [ "bluechip_owner" ], "wallet_address": "Chhr2crC5mGdrY4Qj6EJcHxiUjTS6fafu1rueHKoiX4a" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "583jfBFz3NzzfRU14tCUhoQnHnMRpyGSxdvxWR8V1SnU" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot" ], "wallet_address": "26ooGGTHJwqr56cNg68oQge98LHw7Gq6HQw4grycFtEb" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "GCvHhEUYQwTJ8jyf8Lc4bv8jBXyZU4LMMsZCobwEPzvM" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "3pcz387Lg1xgYDQxgt3nSSzMV5u4PqmvjwgQ9qa66MNa" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "MRiYA4oN3158fCV8evhuCofrDzbHyYvYnGZUDJvoCsa" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "HjjhSHoQPg2smsB4GxbVGW2hT8nm7748azFsJ4q5VHKX" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "8NQ32SyFKD1d5kenq4oM8Da6C6J9TQSMW1uAgFRveEQr" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "BbYqq9czWV5bSJnVi8EQDeHcu6yqzXp7myVrG8ajnGDU" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot" ], "wallet_address": "EMieN7ZeEKnx6Dig7MDU4MnRtSfZNpi4KviSeZKku67o" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "JApBGtbBtsNosE1Z5CiyUkTMhAxATqH1NAuJJenHUceR" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "DcQNaByvstRZCERvb9UJHgHiQe8YX2FMdPptM86psQyz" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot" ], "wallet_address": "riDi6z4Lzch9FvcEzmkkx9gqCoPniMrTMFchbGaikGq" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "GRJwgkcpADQN2mjBbeKNmUH8EEToRYn5NSRJvGqNBsJZ" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "6ELNUJy7cK7M3mU3iZpSiGoVPAyxXvdDFrUZdCBZMzop" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "FkdDHrM8j8psKbxuwjV1jBKCM2JGPygkj7WCX8sSCzNm" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "2AVcqTxEQrC1zrtwCNZSBr6w1hG3M5sRjWD73MMqVQJd" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "FpJkAdyH2smVeXAGWJdt6zpQCfmgsTqXLVqtJQSDgNCU" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "bluechip_owner" ], "wallet_address": "2S9P68PuppujppmGAdvmG6x1Q7P3oVDyZxcpFkSXmUJT" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "5FFqNVN4uHqor1izcLfpxam8b8NC7nVmXfNb2dT1DCaK" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "rLsi2DPwRLovHzLV5XYxa8B597bv8w8nX7fZHJJf8uy" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "3RvuW1JeFV9gvcCx1FaGoga7uEomcw8gJCdTS5AiLXWD" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "7nwPXZNhBj88jcC22VNBQUYLohTsQWh5VGxWqnAAcvMf" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "4eQJuwznAD6LyVKs8vhnTWnQ6GuSXS6aYNiAasMx74Cw" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "3dozCLAkkP2crzAggABNwFejj2LjAAFJSpDkVDDoBWwu" }, { "maker_token_tags": [ "sniper" ], "status": null, "tags": [], "wallet_address": "Fqqxv7iyH4Pym8s88BpcEK325pZJz8RhfBGF2onzK5Up" }, { "maker_token_tags": [ "sniper" ], "status": null, "tags": [], "wallet_address": "2FmUa8JYozQgeJjGpATXpDyQqbTgLCWKFXYjdE6pLEhS" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "bluechip_owner" ], "wallet_address": "FHcck5GwuwpmoPn62aPwjayjEKHrKh6TMZKJJwGELsFr" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "bluechip_owner" ], "wallet_address": "78QDuKfL9hVX3BLgze2KFgc4hTcXhTrd26E58bwz6V8y" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "bluechip_owner" ], "wallet_address": "EmD3kNjyENyiqZwXWEKe5AqiCJ9ZTBg1UbepWxnUtKzQ" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "zBWgbKnu6KVRSwERFuwkD95b5BX5pBJriq3VNmzp5oN" }, { "maker_token_tags": [ "sniper" ], "status": "hold", "tags": [], "wallet_address": "46JVpKhvRuf1eQLzRrKpe94FNTSoWcTj5HLK9kBUe9ZP" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "GqVZjGJSqAPcJdGGF8AXp8VeChAu6cfHc2q1YqhbLj9c" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "CLo55cDQFu2fdykDZuSpo9JzjDa7rZH8Vz2LLNf3G3c9" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "gmgn" ], "wallet_address": "2bkeo5robhyfYjNSxzx8BrATsKb5kT6KrBpTfBr9UGJv" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "sandwich_bot" ], "wallet_address": "JD6rVaerbyz6wjQ433nrw6bFTgFrp46MiYmi8EtUAfsG" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "ESuvjvsQtjuxC4XGsDeMhx8Wp5yjQcCFGncGhupcJbg8" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "91iTFhWfwMJbATjymCBcY8uWN71F9FL8DYbTwjA8iCAp" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "theo9SfM3dKgKFbq4kFVmEXwSQ1pdr61wDqEWXKJpYs" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "EJJ46XBHxnwfynXtscd7MDPFmLoyKS97iVZEAQ8pMzms" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "8WK46RtvfmDVEgTFLU1BRmp5ELJqJe2fEPzRggbVSuim" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "eLLnsiBsWvERB34kgiJ4wPhdRzqM17gMG4cHouMqaHz" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "HN7WRRpSQxZN8QvvNhD9sV9sZrYGw5EJgGkzZ6koiuk1" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "EARKA8h3jaBZtcAnSbf4MBiPSbUVYPpE9H6XwZk2PHR8" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [ "bluechip_owner" ], "wallet_address": "ttcZfmd93bR1UWoGGJNyNVCkuMLAo9L2rzuxbtPbNDq" }, { "maker_token_tags": [ "sniper" ], "status": "sold", "tags": [], "wallet_address": "4toj6xGJUSL7io9MrZViewwhU2zj7SJyCSHu7LnByi5u" }, { "maker_token_tags": [ "sniper" ], "status": "bought_more", "tags": [ "bluechip_owner" ], "wallet_address": "5RavSBTfaaLhiA8SjTs59BdupNJS5axntifVk7x7PL65" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "sandwich_bot", "bluechip_owner" ], "wallet_address": "En3NPq8o9Cynf1Q3eP69AqZmPKmBaDugYnE832o2YuzP" }, { "maker_token_tags": [ "sniper" ], "status": "sold_part", "tags": [ "bluechip_owner" ], "wallet_address": "7HsyYYLEP5nRMcSfkkbe1zYCW5ps951q33kPfvqr3jBL" } ], "chain": "sol", "holder_count": 66, "observed_at_ms": 1791143808408, "source_url": "https://gmgn.ai/sol/token/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "status": { "bought_more": 3, "bought_rate": 0.000587103, "hold": 1, "holding_rate": 0.000151865, "sold": 36, "sold_part": 23, "top_10_holder_rate": 0.2867, "transfered": 0 }, "top70_sniper_hold_rate": 0.0000240952 } ``` ### Trending tokens - Capability: `crypto/trending_tokens` - Description: Trending tokens on one chain from gmgn.ai's Trend page (`GET /api/v1/rank/{chain}/swaps/{period}`): price, change, volume, liquidity, market cap, swaps, holders, launchpad, security flags and gmgn's smart-money/sniper/bundler counts, in the site's rank order. - Instructions: Token discovery: what is trading most right now on sol, bsc, base, eth, monad or tron. Take `address` into token_detail, token_trades, token_holders or token_candles. - Cost: 5 credits per call - Capability file: [Trending tokens](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/trending_tokens) Accepted options: - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `direction` (string): direction Example: `desc` - `limit` (number): Maximum tokens. Example: `20` - `period` (string): Ranking window. Example: `1h` - `sort_by` (string): Ranking field. Example: `swaps` Response schema example: ```json { "chain": "sol", "count": 3, "direction": "desc", "observed_at_ms": 1791143703045, "period": "1h", "sort_by": "swaps", "tokens": [ { "address": "H7wJ1wbbdu4ZCom6yegVaJxWBvdjLQ3NaNZbJsb8vAni", "bot_degen_count": 1541, "bot_degen_rate": 0.7049, "bundler_rate": 0.5293, "burn_ratio": 0.002692066876872547, "burn_status": "burn", "buys": 12099, "chain": "sol", "creation_timestamp": 1791141770, "creator": "G48toLx8WLqWqfBxTgEWTDE3kVcuVwrjJ12UnVYJ2VuW", "creator_token_status": "creator_close", "dev_team_hold_rate": 0.0291559537, "exchange": "meteora_damm_v2", "holder_count": 2531, "hot_level": 3, "is_honeypot": false, "is_wash_trading": false, "launchpad": "meteora_virtual_curve", "launchpad_platform": "meteora_virtual_curve", "launchpad_status": "1", "liquidity": 85829.4, "logo": "https://gmgn.ai/external-res/b5b063b750df8cdc3af2d8113d1ecdea_v2.webp", "market_cap": 354552, "name": "Quota", "open_timestamp": 1791141770, "price": 0.000355514, "price_change_percent": 6496.1, "price_change_percent_1h": 6496.1, "price_change_percent_1m": 4.10686, "price_change_percent_5m": 11.6563, "rank": 1, "renounced_freeze_account": true, "renounced_mint": true, "renowned_count": 1, "rug_ratio": 0.386, "score": 2.17566, "sells": 8933, "smart_degen_count": 48, "sniper_count": 0, "source_url": "https://gmgn.ai/sol/token/H7wJ1wbbdu4ZCom6yegVaJxWBvdjLQ3NaNZbJsb8vAni", "swaps": 21032, "symbol": "QUOTA", "telegram": null, "top_10_holder_rate": 0.1895, "total_supply": 997294639, "twitter": "https://x.com/search?q=$QUOTA", "volume": 1910220, "website": "https://hudnel.com" }, { "address": "G3i7LpQgFCyYebYpbdbHG47Gx6Tp4euJPqJmGiy6pump", "bot_degen_count": 23, "bot_degen_rate": 0.1366, "bundler_rate": 0.1354, "burn_ratio": 0, "burn_status": "burn", "buys": 9260, "chain": "sol", "creation_timestamp": 1791141138, "creator": "8QNHFJgFqiNCpCtsxeqmsBjhRBeWoahpjFxmDtJ2iZ6R", "creator_token_status": "creator_close", "dev_team_hold_rate": 0.1353897109, "exchange": "pump_amm", "holder_count": 2183, "hot_level": 3, "is_honeypot": false, "is_wash_trading": false, "launchpad": "pump", "launchpad_platform": "Pump.fun", "launchpad_status": "1", "liquidity": 90276.5, "logo": "https://gmgn.ai/external-res/60eeba9bdc9095fe5c0f9119902bc3fc_v2.webp", "market_cap": 1041160, "name": "X（Official Twitter））", "open_timestamp": 1791141138, "price": 0.00104657, "price_change_percent": 7931.37, "price_change_percent_1h": 7931.37, "price_change_percent_1m": 2.1959, "price_change_percent_5m": 14.6746, "rank": 2, "renounced_freeze_account": true, "renounced_mint": true, "renowned_count": 0, "rug_ratio": 0.9690721649484536, "score": 1.7823, "sells": 8705, "smart_degen_count": 0, "sniper_count": 1, "source_url": "https://gmgn.ai/sol/token/G3i7LpQgFCyYebYpbdbHG47Gx6Tp4euJPqJmGiy6pump", "swaps": 17965, "symbol": "X", "telegram": null, "top_10_holder_rate": 0.1391, "total_supply": 994829021, "twitter": "https://x.com/X", "volume": 75019.1, "website": "https://x.com" }, { "address": "6PHzFRk2BxbBz4WMVV9Ze4HCe1ckA8GszcodpWEdpump", "bot_degen_count": 1034, "bot_degen_rate": 0.4228, "bundler_rate": 0.3667, "burn_ratio": 0, "burn_status": "burn", "buys": 8770, "chain": "sol", "creation_timestamp": 1791141959, "creator": "6KmRKeD19E2QR3MuPoFKPU6Z8mxWrHL9xU9YfakvCASg", "creator_token_status": "creator_close", "dev_team_hold_rate": 0, "exchange": "pump_amm", "holder_count": 2224, "hot_level": 3, "is_honeypot": false, "is_wash_trading": false, "launchpad": "pump", "launchpad_platform": "Pump.fun", "launchpad_status": "1", "liquidity": 29099.9, "logo": "https://gmgn.ai/external-res/b4204341ca1fa302e5170e1ef3d3a90c_v2.webp", "market_cap": 121135, "name": "Stream.fun", "open_timestamp": 1791141959, "price": 0.000126576, "price_change_percent": 3611.38, "price_change_percent_1h": 3611.38, "price_change_percent_1m": 5.92752, "price_change_percent_5m": 0.0472827, "rank": 3, "renounced_freeze_account": true, "renounced_mint": true, "renowned_count": 0, "rug_ratio": 0.516, "score": 1.86793, "sells": 4623, "smart_degen_count": 6, "sniper_count": 0, "source_url": "https://gmgn.ai/sol/token/6PHzFRk2BxbBz4WMVV9Ze4HCe1ckA8GszcodpWEdpump", "swaps": 13393, "symbol": "STREAM", "telegram": null, "top_10_holder_rate": 0.2319, "total_supply": 957014621, "twitter": "https://x.com/streamfunapp", "volume": 471443, "website": "https://www.streamfun.app/" } ] } ``` ### Wallet profile - Capability: `crypto/wallet_profile` - Description: Trading statistics for one wallet (`GET /api/v1/wallet_stat/{chain}/{address}/{period}`): PnL, realized/unrealized profit, win rate, token counts by PnL bucket, native balance, tags, funding source and social binding. Not-found when gmgn.ai has no activity for the address. - Instructions: Profile a wallet from wallet_rank, token_holders, token_trades or a gmgn.ai address URL. - Cost: 5 credits per call - Capability file: [Wallet profile](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/wallet_profile) Accepted options: - `address` (string): Wallet address on `chain`: base58 for sol/tron, 0x-prefixed hex for EVM chains. Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$. Example: `
` - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `period` (string): period Example: `7d` - `url` (string): Alternative to chain+address: a gmgn.ai address page URL such as https://gmgn.ai/sol/address/. Pattern: ^https?://(www\.)?gmgn\.ai/. Example: `` Response schema example: ```json { "address": "G8xsXadFYDrjqxbzaj7TXFsAzKPEuY6gXy9sDcf3DkR1", "all_pnl": 0.36865238489398133, "avatar": null, "avg_holding_period": 0, "balance": 31.297863169, "buy": 0, "chain": "sol", "creator_created_count": 16, "ens": null, "follow_count": 63, "followers_count": 0, "fund_from": "Binance", "fund_from_ts": 1790367471, "gas_cost": 0, "history_bought_cost": 0, "is_contract": false, "last_active_timestamp": 1791131640, "name": null, "observed_at_ms": 1791143848587, "period": "7d", "pnl": 0, "pnl_buckets": { "gt_5x": 0, "lt_2x": 0, "lt_minus_50pct": 0, "minus_50pct_to_0": 0, "x2_to_5x": 0 }, "profit_num": 0, "realized_profit": 15187.9503515877, "remark_count": 58, "sell": 0, "source_url": "https://gmgn.ai/sol/address/G8xsXadFYDrjqxbzaj7TXFsAzKPEuY6gXy9sDcf3DkR1", "tags": [ "axiom" ], "token_avg_cost": 0, "token_num": 0, "token_sold_avg_profit": 0, "total_profit": 15175.73560506172, "total_profit_pnl": 0.17736879966878047, "total_value": 0, "total_volume": 100748.29486201445, "twitter_fans_num": 0, "twitter_name": null, "twitter_username": null, "unrealized_pnl": -0.0002753439444929284, "unrealized_profit": -12.214746525979464, "winrate": 0 } ``` ### Wallet rank - Capability: `crypto/wallet_rank` - Description: gmgn.ai's smart-money wallet leaderboard for one chain (`GET /api/v1/rank/{chain}/wallets/{period}`): PnL, realized profit, win rate, trade counts, tags and the 7-day daily profit series per wallet. - Instructions: Find top-performing wallets to inspect with wallet_profile or dev_created_tokens. - Cost: 5 credits per call - Capability file: [Wallet rank](https://firecrawl.dev/alexandria/agents/providers/gmgn-ai/crypto/wallet_rank) Accepted options: - `chain` (string): Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. Example: `sol` - `limit` (number): Maximum wallets (the site returns 100 per call). Example: `20` - `period` (string): Leaderboard window. Example: `7d` - `sort_by` (string): Ranking field. Example: `pnl_7d` Response schema example: ```json { "chain": "sol", "count": 3, "observed_at_ms": 1791143731762, "period": "7d", "sort_by": "pnl_7d", "wallets": [ { "address": "4vw54BmAogeRV3vPKWyFet5yf8DTLcREzdSzx4rw9Ud9", "avg_cost_7d": 82.34661108756706, "avg_holding_period_7d": 736557.7192273135, "balance": 1049.042485395, "buy_7d": 6349, "chain": "sol", "daily_profit_7d": [ { "profit": 8133.545728896354, "timestamp": 1790467200 }, { "profit": 320400.68451082427, "timestamp": 1790553600 }, { "profit": 14410.50386625533, "timestamp": 1790640000 }, { "profit": 18865.767893047923, "timestamp": 1790726400 }, { "profit": 36684.629615275575, "timestamp": 1790812800 }, { "profit": 32024.49407027127, "timestamp": 1790899200 }, { "profit": 26410.061578426597, "timestamp": 1790985600 } ], "ens": null, "follow_count": 65815, "last_active": 1791141390, "name": "decu", "pnl_1d": 0.2423708454315871, "pnl_30d": 0.3064626064284378, "pnl_7d": 0.661301994534859, "realized_profit_1d": 23267.60430812941, "realized_profit_30d": 814453.7633549138, "realized_profit_7d": 465491.73532352695, "remark_count": 14340, "sell_7d": 8098, "source_url": "https://gmgn.ai/sol/address/4vw54BmAogeRV3vPKWyFet5yf8DTLcREzdSzx4rw9Ud9", "tags": [ "photon", "kol", "wash_trader", "arbitrager", "padre", "top_followed", "top_renamed", "axiom" ], "twitter_name": "decu", "twitter_username": "notdecu", "txs_7d": 14447, "volume_7d": 1266155.9376372388, "winrate_1d": 0.6745562130177515, "winrate_30d": 0.4606550404083369, "winrate_7d": 0.3694362017804154 }, { "address": "8deJ9xeUvXSJwicYptA9mHsU2rN2pDx37KWzkDkEXhU6", "avg_cost_7d": 621.7286854479694, "avg_holding_period_7d": 135803.78496669838, "balance": 242.130704827, "buy_7d": 1771, "chain": "sol", "daily_profit_7d": [ { "profit": -7314.782699610078, "timestamp": 1790467200 }, { "profit": 17841.39704990638, "timestamp": 1790553600 }, { "profit": 21633.470433239807, "timestamp": 1790640000 }, { "profit": 53689.83080975063, "timestamp": 1790726400 }, { "profit": -2393.163024074953, "timestamp": 1790812800 }, { "profit": 34746.19277142934, "timestamp": 1790899200 }, { "profit": 28229.986449054966, "timestamp": 1790985600 } ], "ens": null, "follow_count": 63095, "last_active": 1791141267, "name": "Cooker.hl | 版本之子 |🅿️ (Theo Arc)", "pnl_1d": 0.6631548057421296, "pnl_30d": 0.1681228982182923, "pnl_7d": 0.2497521305371207, "realized_profit_1d": 16102.779342742475, "realized_profit_30d": 591407.7705853519, "realized_profit_7d": 169400.25258998593, "remark_count": 44518, "sell_7d": 966, "source_url": "https://gmgn.ai/sol/address/8deJ9xeUvXSJwicYptA9mHsU2rN2pDx37KWzkDkEXhU6", "tags": [ "wash_trader", "axiom", "trojan", "photon", "kol", "app_smart_money", "gmgn_go", "gmgn", "top_followed", "top_renamed" ], "twitter_name": "Cooker.hl | 版本之子 |🅿️ (Theo Arc)", "twitter_username": "CookerFlips", "txs_7d": 2737, "volume_7d": 1706723.767456185, "winrate_1d": 0.7037037037037037, "winrate_30d": 0.7181895815542272, "winrate_7d": 0.7404718693284936 }, { "address": "ardinRsN1mNYVeoJWTBsWeYeXvuR9UUDGMsCDKpb6AT", "avg_cost_7d": 106.77207126973556, "avg_holding_period_7d": 146709.09008464328, "balance": 896.885271272, "buy_7d": 4090, "chain": "sol", "daily_profit_7d": [ { "profit": 14704.860089820419, "timestamp": 1790467200 }, { "profit": 6896.234799483816, "timestamp": 1790553600 }, { "profit": 15342.521838475119, "timestamp": 1790640000 }, { "profit": 17236.195138280604, "timestamp": 1790726400 }, { "profit": 16299.948356849483, "timestamp": 1790812800 }, { "profit": 7528.3988060992115, "timestamp": 1790899200 }, { "profit": 14855.859000289804, "timestamp": 1790985600 } ], "ens": null, "follow_count": 30156, "last_active": 1791141340, "name": "trunoest", "pnl_1d": 0.1840327655358179, "pnl_30d": 0.1737628547970486, "pnl_7d": 0.1678732361888186, "realized_profit_1d": 14631.594936010448, "realized_profit_30d": 398400.91214925627, "realized_profit_7d": 86322.49845285213, "remark_count": 6098, "sell_7d": 1517, "source_url": "https://gmgn.ai/sol/address/ardinRsN1mNYVeoJWTBsWeYeXvuR9UUDGMsCDKpb6AT", "tags": [ "kol", "wash_trader", "launchpad_smart", "arbitrager", "bluechip_owner", "top_followed", "top_renamed", "axiom" ], "twitter_name": "trunoest", "twitter_username": "trunoest", "txs_7d": 5607, "volume_7d": 993626.8949427808, "winrate_1d": 0.5975609756097561, "winrate_30d": 0.5627476882430648, "winrate_7d": 0.5798755186721992 } ] } ```