[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [GMGN new token pairs](https://spiral.ai/integrations/gemini-cli/gmgn-new-token-pairs)

# How to Use GMGN new token pairs in Gemini CLI

Returns recently launched token pairs from GMGN. Use it to discover new launches for further research before they enter an established token watchlist.

|  |  |
| --- | --- |
| Model | GMGN new token pairs |
| 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 new token pairs in Gemini CLI

- Use GMGN new token pairs to fetch recent Base launches and build a research queue in this project.
- Use GMGN new token pairs to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from GMGN new token pairs and tell me what changed since last week.
- Check GMGN new token pairs and summarize what you find in three bullet points.
- Pull the newest data from GMGN new token pairs and give me the result as a table.

## How to set up GMGN new token pairs 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:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
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.

```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 new token pairs**: 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/new_pairs",
    "input": {
      "chain": "sol"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds GMGN new token pairs on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## GMGN new token pairs tools and prices

- [GMGN · New pairs](https://spiral.ai/tools/alexandria/gmgn-ai/crypto/new_pairs) (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 pairs. |
| period | 1m, 5m, 1h, 6h, 24h | 1h | Look-back window. |
| exclude_honeypots |  | — | Apply the site's not_honeypot filter. |

## What can you do with GMGN new token pairs in Gemini CLI?

Build a GMGN research view that puts token market activity, launch records, ownership, and discussion beside each other. A coding agent can turn the returned data into project components and comparison reports.

### New-launch research brief

Discover recent pairs, resolve their contracts, and prepare a brief combining token details, candles, transactions, ownership, trader outcomes, early buyers, developer launches, and community discussion.

### Daily token research digest

Combine newly discovered launches with an existing token watchlist. Report market changes, supply distribution, trading outcomes, early-buyer positions, developer activity, and discussion themes for an internal research meeting.

### Developer launch comparison

Compare recent pairs with other tokens created by their developer addresses. Resolve contract matches and examine token details, holder distribution, and early-buyer positions across the launches.

### Token market dashboard

Build a dashboard that adds recent pairs, resolves names to contracts, displays token summaries, and charts candles beside the transaction feed.

### Launch cohort research

Collect a cohort of newly discovered token contracts and revisit their market activity, ownership, trading outcomes, early buyers, developer records, and community discussion. Compare how the launches develop over the observation period.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## GMGN new token pairs in other agents

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

## More Gemini CLI guides

- [GMGN developer token launches](https://spiral.ai/integrations/gemini-cli/gmgn-developer-token-launches)
- [GMGN token community posts](https://spiral.ai/integrations/gemini-cli/gmgn-token-community-posts)
- [Forex Factory release history](https://spiral.ai/integrations/gemini-cli/forex-factory-release-history)
- [GMGN token details](https://spiral.ai/integrations/gemini-cli/gmgn-token-details)
- [Forex Factory indicator search](https://spiral.ai/integrations/gemini-cli/forex-factory-indicator-search)
- [GMGN token early buyers](https://spiral.ai/integrations/gemini-cli/gmgn-token-early-buyers)

## Questions about GMGN new token pairs in Gemini CLI

**Can Gemini CLI use GMGN new token pairs?**

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

**How much does GMGN new token pairs 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 new token pairs in Gemini CLI?**

No. Spiral runs GMGN new token pairs 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 new token pairs in Gemini CLI?**

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

**Does Gemini CLI wait while GMGN new token pairs runs?**

GMGN new token pairs runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Which blockchains does the documented GMGN data cover?**

The documented coverage includes six chains: Solana, Ethereum, Base, BNB Smart Chain, Tron, and Monad.

**How fresh is GMGN’s transaction data?**

GMGN describes its latest transaction information as updating in real time. That description applies to transaction activity, rather than establishing a refresh schedule for every GMGN dataset.

**What does GMGN mean by early buyers?**

GMGN’s early-buyer display examines the first 70 buyers. It separates them by holding and selling status, so early participation and current ownership can be examined separately.

**Can GMGN show a token developer’s previous launches?**

GMGN’s developer token view lists tokens created by the same developer address. This gives an address-level launch record rather than a verified history of a person or company.

