gmgn.ai APIgmgn.ai ↗
Access gmgn.ai data via API: trending Solana tokens, OHLCV candles, holder stats, trade history, security flags, and top trader wallet rankings.
curl -X GET 'https://api.parse.bot/scraper/fd0acc27-2d9b-49ca-b8ff-216a1b3ce0e0/get_trending_tokens?orderby=volume&direction=desc&timeframe=1h' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve trending tokens on a given timeframe for Solana chain. Returns an array of ranked tokens with price, volume, market cap, holder count, and security indicators.
| Param | Type | Description |
|---|---|---|
| filters | string | Comma-separated filters: renounced, frozen, not_honeypot, has_twitter, has_website |
| orderby | string | Field to order by: swaps, volume, market_cap |
| direction | string | Order direction: asc or desc |
| timeframe | string | Timeframe for trending data: 1m, 5m, 1h, 6h, 24h |
{
"type": "object",
"fields": {
"rank": "array of token objects with address, name, symbol, price, volume, market_cap, holder_count, swaps, and security flags"
},
"sample": {
"data": {
"rank": [
{
"name": "meme mode",
"rank": 1,
"price": 0.000148121,
"swaps": 15025,
"symbol": "MEMELON",
"volume": 657332,
"address": "GLpMf2yfRsnxRMd7VQJVguHAagE1dK5cyrKehQJA2vqN",
"market_cap": 148120,
"holder_count": 1210,
"renounced_mint": 1,
"price_change_percent": 4889.52,
"renounced_freeze_account": 1
}
]
},
"status": "success"
}
}About the gmgn.ai API
The gmgn.ai API exposes 8 endpoints covering real-time Solana token analytics, from trending token rankings to per-wallet profit/loss profiles. get_trending_tokens returns ranked tokens filterable by security properties like renounced, frozen, and not_honeypot, while get_token_info delivers holder concentration metrics, dev team hold rate, and launchpad details for any contract address.
Token Discovery and Trending Data
The get_trending_tokens endpoint returns a ranked array of Solana tokens across five timeframes (1m, 5m, 1h, 6h, 24h). Results can be ordered by swaps, volume, or market_cap in either direction and filtered by comma-separated flags such as has_twitter, has_website, not_honeypot, and renounced. Each token object includes address, name, symbol, price, volume, market_cap, holder_count, and attached security indicators — making it suitable for building scanners that surface new tokens matching specific safety criteria.
Token-Level Analytics
get_token_info returns two structured objects for a given contract address: stat (which includes holder_count, top_10_holder_rate, dev_team_hold_rate, and bot_degen_count) and security (which includes renounced_mint, is_honeypot, and burn_ratio alongside launchpad metadata). Pair this with get_token_candles for OHLCV data at resolutions from 1m to 1d, or get_token_trades for paginated trade history where each record exposes maker, base_amount, quote_amount, amount_usd, event (buy or sell), tx_hash, and price_usd. Trade pagination uses a cursor returned in the next field of each response.
Holder and Wallet Data
get_token_holders returns holders ordered by amount_percentage descending, with per-holder fields for balance, usd_value, realized_profit, and wallet classification tags. get_wallet_rankings surfaces the top trader leaderboard filterable by period (1d, 7d, 30d) and sortable by fields like realized_profit_7d or pnl_7d. Each wallet entry includes winrate_7d, trade counts, and optional twitter_username. For a specific address, get_wallet_profile returns sol_balance, total_profit, realized_profit, a risk object with honeypot_ratio and fast_tx metrics, and linked social handles.
Search
search_tokens accepts a free-text query (token name, symbol, or contract address) and returns two arrays: coins with price, mcp (market cap), liquidity, and holder_count; and wallets with associated Twitter data and balances. This makes it straightforward to resolve a ticker symbol to a contract address before calling other endpoints.
- Build a Solana token scanner that filters trending tokens by
not_honeypotandrenouncedflags before alerting users - Monitor dev team and top-10 holder concentration via
dev_team_hold_rateandtop_10_holder_rateto assess rug risk - Plot intraday price charts using OHLCV data from
get_token_candlesat 1-minute or 5-minute resolution - Paginate through full trade history for a token using the cursor returned by
get_token_trades - Rank wallets by 7-day realized profit using
get_wallet_rankingsto identify consistently profitable traders - Resolve a token ticker to its contract address via
search_tokensbefore fetching holder or security data - Assess wallet risk profile using
honeypot_ratioandfast_txfields fromget_wallet_profile
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does gmgn.ai have an official public developer API?+
What security data does `get_token_info` return, and how granular is it?+
get_token_info returns a security object with boolean flags including renounced_mint and is_honeypot, plus a burn_ratio value and launchpad attribution. The stat object adds holder-side signals: top_10_holder_rate, dev_team_hold_rate, and bot_degen_count. These are token-level snapshots, not historical security audit trails.Does the API cover chains other than Solana?+
How does pagination work for trade history and holder lists?+
get_token_trades and get_token_holders both return a next field in the response. Pass that value as the cursor parameter in your next request to fetch the following page. There is no page-number-based pagination; only cursor-based traversal is supported.Is wallet portfolio history or unrealized PnL per token position available?+
get_wallet_profile exposes total_profit (which includes unrealized gain) and realized_profit as aggregate figures, but per-token position breakdowns and historical portfolio snapshots are not currently returned. You can fork this API on Parse and revise it to add an endpoint for per-token wallet position detail.