Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Finance

How to Use GMGN wallet rankings in Gemini CLI

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.

Prompts to try with GMGN wallet rankings in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

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.

GMGN wallet rankingsGemini CLI
Try asking
  • 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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.

    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.

    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: Gemini CLI finds GMGN wallet rankings on Spiral, shows the price and runs it.

GMGN wallet rankings providers and prices

Spiral runs GMGN wallet rankings through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
GMGN · Wallet rank
gmgn-ai/crypto/wallet_rank

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Chainsol, eth, base, bsc, tron, or monadsol

Chain slug as gmgn.ai uses it in its URLs (sol, eth, base, bsc, tron, monad). Default sol.

Limit1 to 10020

Maximum wallets (the site returns 100 per call).

Period1d, 7d, or 30d7d

Leaderboard window.

Sort bypnl_1d, pnl_7d, pnl_30d, realized_profit_1d, realized_profit_7d, realized_profit_30d, winrate_7d, or txs_7dpnl_7d

Ranking field.

Every API field of GMGN · Wallet rank is on its tool page: open its card above.

What can you do with GMGN wallet rankings in Gemini CLI?

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.

Questions about GMGN wallet rankings in Gemini CLI

Can Gemini CLI use GMGN wallet rankings?

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

How much does GMGN wallet rankings cost in Gemini CLI?

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

Do I need an Alexandria account to use GMGN wallet rankings in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while GMGN wallet rankings runs?

GMGN wallet rankings runs in the background. Gemini CLI 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.

Get started

Start using GMGN wallet rankings in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options