GMGN AI 工作流

Required for swap / order only:

GMGN_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n<base64>\n-----END PRIVATE KEY-----\n" EOF ```

With server-side filters: safe preset + require smart money + sort by smart degen count

gmgn-cli market trenches \ --chain sol --type new_creation \ --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count

Quotes use signed auth and require GMGN_PRIVATE_KEY on every chain

gmgn-cli order quote \ --chain bsc \ --from <wallet-address> \ --input-token <input-token-addr> \ --output-token <output-token-addr> \ --amount 1000000000000000000 \ --slippage 0.01

Swap with Take-Profit / Stop-Loss Orders (requires private key)

hold_amount mode — each condition order fires based on current holdings at trigger time:

```bash

Limit Orders (requires private key)

```bash

List open strategy orders (requires private key)

gmgn-cli order strategy list --chain sol

Cooking (requires private key)

```bash

1. Installation

Prerequisites: Before installing, create your API Key at https://gmgn.ai/ai (see Section 3 for the full setup guide).

Choose one of the following methods:

1.2 npm Global Install

npm install -g gmgn-cli

Quick Start

Note for AI assistants: If you are an AI Agent helping the user install or configure gmgn-cli, jump directly to Quick Start (AI Agent) — it contains all the steps you need to complete, including how to guide the user through API key generation. If the user asks to upgrade, jump to Upgrade (AI Agent).

Ready to install? Jump to Installation →

Already installed? Upgrade Skills and CLI →

Tip: If your AI agent tries to open or scrape the gmgn.ai website instead of using the CLI, add this to your prompt: Use gmgn-cli commands. Do not call gmgn.ai web endpoints directly.

---

Quick Start (AI Agent)

The following steps are for AI Agents. Some steps require the user to complete actions in a browser.

Step 1 — Install CLI and Skills

npx skills add GMGNAI/gmgn-skills

Step 2 — Verify CLI installation (demo key)

GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3

If JSON output appears, the CLI is installed correctly. Setup is NOT yet complete — this is a public demo key for testing only. You must continue to Steps 3–4 to configure the user's personal API key. Do not stop here.

Step 3 — REQUIRED: Set up personal API key

⚠️ This step is mandatory. The demo key in Step 2 supports testing only and is not for actual use.

Immediately tell the user the following, then run the key generation command without waiting for them to ask:

"To use GMGN Skills, you need your own API key from https://gmgn.ai/ai. I'm generating an Ed25519 key pair for you now."

Run:

openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
  openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null

Show the public key to the user with the following instructions:

This is your Ed25519 public key. Please complete these two steps: 1. Go to https://gmgn.ai/ai, paste the public key above into the API Key creation form, and submit. 2. Once created, copy the API Key shown on the page and send it back to me — I'll handle Step 4 configuration for you.

Wait for the user to reply with their API Key before continuing to Step 4.

Step 4 — Configure credentials

After the user receives their API key, write it to the global config:

```bash mkdir -p ~/.config/gmgn

6. Usage

Examples

Natural language prompts you can send to any AI assistant with gmgn-cli skills installed:

buy 0.1 SOL of <token_address>
sell 50% of <token_address> on BSC
sell 30% of my <token_address> position
get a quote: how much <token_address> can I get for 1 SOL?
check order status <order_id>
is <token_address> safe to buy on solana?
show top holders of <token_address>
show smart money holdings of <token_address>, sorted by buy volume
show recent KOL trades for <token_address>
show my wallet holdings on SOL
query token details for 0x1234...
show 24h K-line and volume for <token_address>
show trading stats for wallet <wallet_address> on BSC
show recent trades for wallet <wallet_address>
which wallets are linked to my API key, and what are their balances
show the latest smart money trades on SOL
show what KOLs are buying on SOL
show newly launched tokens on Solana
show Solana 1-minute trending tokens

Demo Cases

4. Configure Your API Key

Option 1: Global config (recommended)

Create ~/.config/gmgn/.env once — works from any directory:

```bash mkdir -p ~/.config/gmgn cat > ~/.config/gmgn/.env << 'EOF' GMGN_API_KEY=your_api_key_here

Option 2: Project `.env`

```bash cp .env.example .env

Edit .env and fill in your values

```

Config lookup order: ~/.config/gmgn/.env → project .env (project takes precedence).

Write API key (replace with the actual key the user provides)

echo 'GMGN_API_KEY=<user_api_key>' > ~/.config/gmgn/.env chmod 600 ~/.config/gmgn/.env

If the user also needs swap or order capability, append the private key:

3. Get Your Own API Key

The public key in step 2 is for testing only. Apply for your own API key at https://gmgn.ai/ai — required for all actual use (read-only and swap). You will need:

8. CLI Reference

Full parameter reference: docs/cli-usage.md. All commands support --raw for single-line JSON output (pipe-friendly, e.g. | jq '.price').

Wallets and balances linked to API key

gmgn-cli portfolio info

Typical Workflows

Research a token:

token info  →  token security  →  token pool  →  token holders

Analyze a wallet:

portfolio holdings  →  portfolio stats  →  portfolio activity

Execute a trade:

token info (confirm token)  →  portfolio token-balance (check funds)  →  swap  →  order get (poll status)

Discover trading opportunities via trending:

market trending (top 50)  →  AI selects top 5 by multi-factor analysis  →  user reviews  →  token info / token security  →  swap

---

7. Workflow Docs

Step-by-step guides for common analysis tasks: