[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [GMGN wallet rankings](https://spiral.ai/integrations/claude-code/gmgn-wallet-rankings)

# How to Use GMGN wallet rankings in Claude Code

Returns a wallet leaderboard with profit and loss, realized profit, win rates, and transaction counts. Use it to compare performance across the ranked sample and measure how concentrated the results are.

|  |  |
| --- | --- |
| Model | GMGN wallet rankings |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GMGN wallet rankings in Claude Code

- Use GMGN wallet rankings for Ethereum over seven days and add a chart comparing the returned sample's win rates with transaction counts, without displaying wallet addresses.
- Use GMGN wallet rankings for Solana over seven and 30 days, then write an aggregate report in this project comparing realized profit and transaction counts across the returned samples.
- Use GMGN wallet rankings to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from GMGN wallet rankings and tell me what changed since last week.
- Check GMGN wallet rankings and summarize what you find in three bullet points.

## How to set up GMGN wallet rankings in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GMGN wallet rankings**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "gmgn-ai/crypto/wallet_rank",
    "input": {
      "chain": "sol"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds GMGN wallet rankings on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## GMGN wallet rankings tools and prices

- [GMGN · Wallet rank](https://spiral.ai/tools/alexandria/gmgn-ai/crypto/wallet_rank) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| chain | sol, eth, base, bsc, tron, monad | sol | Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol. |
| limit | 1 to 100 | 20 | Maximum wallets (the site returns 100 per call). |
| period | 1d, 7d, 30d | 7d | Leaderboard window. |
| sort_by | pnl_1d, pnl_7d, pnl_30d, realized_profit_1d, realized_profit_7d, realized_profit_30d, winrate_7d, txs_7d | pnl_7d | Ranking field. |

## What can you do with GMGN wallet rankings in Claude Code?

Build an internal GMGN research dashboard with token liquidity, aggregate wallet performance, and public treasury summaries. Add comparisons across observation times and measurement windows so analysts can see what changed.

### Internal market dashboard

Combine token liquidity and volume, aggregate wallet leaderboard statistics, and a public treasury's wallet performance in one research view.

### Morning research brief

Prepare an internal briefing with the most active tokens, the distribution of ranked wallet returns, and a separate performance summary for a public organization wallet.

### Compare short and long windows

Compare short-window token activity with longer-window trends. Separately compare seven-day and 30-day wallet performance to identify results that depend heavily on the measurement window.

### Review changes in a research watchlist

Compare successive observations of token liquidity, aggregate leaderboard performance, and a public treasury's reported profit figures. Flag changes for an analyst's review.

### Measure leaderboard concentration

Calculate how much of the returned sample's realized profit belongs to its highest-ranked wallets. Report the sample size alongside the concentration measure.

### Compare activity with reported success

Analyze win rates alongside transaction counts in the ranked sample, or review those measures for a public treasury. Present aggregate findings without identifying private wallet owners.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## GMGN wallet rankings in other agents

- [Amp](https://spiral.ai/integrations/amp/gmgn-wallet-rankings)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gmgn-wallet-rankings)
- [Claude](https://spiral.ai/integrations/claude-desktop/gmgn-wallet-rankings)
- [Cline](https://spiral.ai/integrations/cline/gmgn-wallet-rankings)
- [Codex](https://spiral.ai/integrations/codex/gmgn-wallet-rankings)
- [Cursor](https://spiral.ai/integrations/cursor/gmgn-wallet-rankings)
- [Devin](https://spiral.ai/integrations/devin/gmgn-wallet-rankings)
- [dots](https://spiral.ai/integrations/dots/gmgn-wallet-rankings)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gmgn-wallet-rankings)
- [Gemini](https://spiral.ai/integrations/gemini/gmgn-wallet-rankings)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/gmgn-wallet-rankings)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gmgn-wallet-rankings)
- [goose](https://spiral.ai/integrations/goose/gmgn-wallet-rankings)
- [Grok](https://spiral.ai/integrations/grok/gmgn-wallet-rankings)
- [Grok Build](https://spiral.ai/integrations/grok-build/gmgn-wallet-rankings)
- [Hermes](https://spiral.ai/integrations/hermes/gmgn-wallet-rankings)
- [Instinct](https://spiral.ai/integrations/instinct/gmgn-wallet-rankings)
- [Manus](https://spiral.ai/integrations/manus/gmgn-wallet-rankings)
- [Muse](https://spiral.ai/integrations/muse/gmgn-wallet-rankings)
- [Muse Code](https://spiral.ai/integrations/muse-code/gmgn-wallet-rankings)
- [n8n](https://spiral.ai/integrations/n8n/gmgn-wallet-rankings)
- [Notion](https://spiral.ai/integrations/notion/gmgn-wallet-rankings)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gmgn-wallet-rankings)
- [opencode](https://spiral.ai/integrations/opencode/gmgn-wallet-rankings)
- [Perplexity](https://spiral.ai/integrations/perplexity/gmgn-wallet-rankings)
- [Raycast](https://spiral.ai/integrations/raycast/gmgn-wallet-rankings)
- [VS Code](https://spiral.ai/integrations/vscode/gmgn-wallet-rankings)
- [Windsurf](https://spiral.ai/integrations/windsurf/gmgn-wallet-rankings)
- [Zapier](https://spiral.ai/integrations/zapier/gmgn-wallet-rankings)

## More Claude Code guides

- [GMGN wallet performance](https://spiral.ai/integrations/claude-code/gmgn-wallet-performance)
- [GlobeNewswire latest press releases](https://spiral.ai/integrations/claude-code/globenewswire-latest-press-releases)
- [GMGN trending tokens](https://spiral.ai/integrations/claude-code/gmgn-trending-tokens)
- [GlobeNewswire press release text](https://spiral.ai/integrations/claude-code/globenewswire-press-release-text)
- [GMGN token trades](https://spiral.ai/integrations/claude-code/gmgn-token-trades)
- [Hyperliquid account cash movements](https://spiral.ai/integrations/claude-code/hyperliquid-account-cash-movements)

## Questions about GMGN wallet rankings in Claude Code

**Can Claude Code use GMGN wallet rankings?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run GMGN wallet rankings like any built-in tool.

**How much does GMGN wallet rankings cost in Claude Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use GMGN wallet rankings in Claude Code?**

No. Spiral runs GMGN wallet rankings on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GMGN wallet rankings in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while GMGN wallet rankings runs?**

GMGN wallet rankings runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**What activity does GMGN measure?**

GMGN covers activity generated by compatible third-party blockchain applications. Its token and wallet statistics describe the blockchain activity the platform monitors.

**Where does GMGN get its data?**

GMGN says its on-chain transaction data and token security information come from multiple third-party providers. Alexandria reads the anonymous JSON API behind GMGN's terminal.

**Are GMGN security indicators immediately current?**

GMGN warns that honeypot detection information can appear with a delay. A displayed security indicator therefore does not establish the contract's current state.

**Does a favorable security check prove a token is safe?**

No. GMGN explicitly says its token security checks cannot guarantee 100% accuracy and recommends comparing multiple security tools.

**What reuse does GMGN's standard license cover?**

GMGN's standard license permits reproducing portions of its services for personal or internal business purposes, subject to its agreement.

