[FINANCIAL EXECUTION] Create tokens on launchpad platforms (Pump.fun, Raydium, PancakeSwap, Flap, FourMeme, Bonk, BAGS, etc.) or query token creation statistics by launchpad. Token creation executes irreversible on-chain transactions. Requires explicit user confirmation before every create. Supports sol / bsc / base / eth / ton.
IMPORTANT: Always use gmgn-cli commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai — all token creation operations must go through the CLI. The CLI handles signing and submission automatically.
IMPORTANT: Do NOT guess field names or values. When a field's meaning is unclear, look it up in the Response Fields sections below before using it.
⚠️ IPv6 NOT SUPPORTED: If you get a 401 or 403 error and credentials look correct, check for IPv6 immediately: (1) list all network interfaces and their IPv6 addresses — run ifconfig | grep inet6 (macOS) or ip addr show | grep inet6 (Linux); (2) send a test request to https://ipv6.icanhazip.com — if the response is an IPv6 address, outbound traffic is going via IPv6. Tell the user immediately: "Please disable IPv6 on your network interface — gmgn-cli commands only work over IPv4."
Use the gmgn-cli tool to create a token on a launchpad platform or query token creation statistics per launchpad. Requires private key (GMGN_PRIVATE_KEY in .env) for cooking create.
Bonding curve — Most launchpad platforms (Pump.fun, FourMeme, Flap, etc.) launch tokens on an internal bonding curve. The token price rises as buyers enter. Once the threshold is reached, the token "graduates" to an open DEX (e.g. Raydium on SOL, PancakeSwap on BSC). Token creation happens on the bonding curve — not the open market.
--buy-amt is in human units — --buy-amt is expressed in full native token units, not smallest unit. 0.01 = 0.01 SOL. 0.05 = 0.05 BNB. Always confirm the human-readable amount with the user before executing.
--dex identifiers — Each launchpad has a fixed identifier passed to --dex. These are not free-form names — use only the identifiers listed in the Supported Launchpads table. Never guess a --dex value not in that table.
Image input — Token logo can be provided as base64-encoded data (--image, max 2MB decoded) or a publicly accessible URL (--image-url). Provide one or the other — not both. If the user gives a file path, read and base64-encode it before passing to --image. If they give a URL, use --image-url directly.
Status polling via order get — cooking create is asynchronous. The immediate response may show pending. Poll with gmgn-cli order get --chain <chain> --order-id <order_id> until confirmed. The new token's contract address is in the output_token field of the order get response, not in the initial create response.
Critical auth — cooking create requires both GMGN_API_KEY and GMGN_PRIVATE_KEY. The private key never leaves the machine — the CLI uses it only for local signing. cooking stats uses normal auth (API Key only).
Slippage — The initial buy is executed as part of the same transaction as token creation. Slippage applies to that buy. Use --slippage (decimal, e.g. 0.01 = 1%) or --auto-slippage. One of the two is required when --buy-amt is set.
This skill executes REAL, IRREVERSIBLE blockchain transactions.
cooking create command deploys an on-chain token contract and spends real funds (initial buy amount).| Sub-command | Description |
|---|---|
cooking stats | Get token creation count statistics grouped by launchpad platform (normal auth) |
cooking create | Deploy a new token on a launchpad platform (requires private key) |
sol / bsc / base / eth / ton
| Chain | --dex values |
|---|---|
sol | pump / raydium / bonk / bags / memoo / letsbonk / bonkers |
bsc | pancakeswap / flap / fourmeme |
base | clanker / flaunch / baseapp / basememe / zora / virtuals_v2 |
When the user names a platform colloquially (e.g. "pump.fun", "four.meme", "PancakeSwap"), map it to the correct --dex identifier from this table before running the command.
cooking stats: Only GMGN_API_KEY requiredcooking create: Both GMGN_API_KEY and GMGN_PRIVATE_KEY must be configured in ~/.config/gmgn/.env. The private key must correspond to the wallet bound to the API Key.gmgn-cli installed globally — if missing, run: npm install -g gmgn-cliIMPORTANT — Credential lookup order: gmgn-cli loads ~/.config/gmgn/.env first, then overlays any .env found in the current working directory (project-level overrides global). If credentials appear missing or wrong, check whether a .env in the workspace directory is shadowing the global config:
ls -la .env 2>/dev/null && echo "WARNING: local .env is overriding ~/.config/gmgn/.env"
If a local .env exists but lacks GMGN_API_KEY / GMGN_PRIVATE_KEY, either add them to that file or remove it so the global config is used.
All cooking routes go through GMGN's leaky-bucket limiter with rate=10 and capacity=10. Sustained throughput is roughly 10 ÷ weight requests/second.
| Command | Weight |
|---|---|
cooking create | 5 |
cooking stats | 1 |
When a request returns 429:
X-RateLimit-Reset from the response headers — Unix timestamp for when the limit resets.reset_at (e.g., {"code":429,"error":"RATE_LIMIT_BANNED","message":"...","reset_at":1775184222}), extract reset_at — it is the Unix timestamp when the ban lifts (typically 5 minutes). Convert to local time and tell the user exactly when they can retry.cooking create is a real transaction: never loop or auto-resubmit after a 429. Wait until the reset time, then ask for confirmation again before retrying.RATE_LIMIT_EXCEEDED or RATE_LIMIT_BANNED, repeated requests during cooldown extend the ban by 5 seconds each time, up to 5 minutes.First-time setup (if credentials are not configured):
Generate key pair and show the public key to the user:
openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null
Tell the user: "This is your Ed25519 public key. Go to https://gmgn.ai/ai, paste it into the API key creation form (enable swap/cooking capability), then send me the API Key value shown on the page."
Wait for the user's API key, then configure both credentials:
mkdir -p ~/.config/gmgn
echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
echo 'GMGN_PRIVATE_KEY="<pem_content_from_step_1>"' >> ~/.config/gmgn/.env
chmod 600 ~/.config/gmgn/.env
GMGN_PRIVATE_KEY is used exclusively for local message signing — the private key never leaves the machine. The CLI computes an Ed25519 signature in-process and transmits only the base64-encoded result in the X-Signature request header.GMGN_API_KEY is transmitted in the X-APIKEY header over HTTPS.cooking stats Usagegmgn-cli cooking stats [--raw]
cooking stats Response Fields| Field | Type | Description |
|---|---|---|
launchpad | string | Launchpad identifier (e.g. pump, raydium, pancakeswap) |
token_count | int | Number of tokens created via GMGN on that launchpad |
cooking create Parameters| Parameter | Required | Description |
|---|---|---|
--chain | Yes | Chain: sol / bsc / base / eth / ton |
--dex | Yes | Launchpad platform identifier — see Supported Launchpads table. Never guess this value. |
--from | Yes | Wallet address (must match API Key binding) |
--name | Yes | Token full name (e.g. Doge Killer) |
--symbol | Yes | Token ticker symbol (e.g. DOGEK) |
--description | No | Token description / project pitch |
--buy-amt | Yes | Initial buy amount in human-readable native token units (e.g. 0.01 = 0.01 SOL). This is NOT in smallest unit. |
--image | No* | Token logo as base64-encoded data (max 2MB decoded). Mutually exclusive with --image-url. One of the two is required. |
--image-url | No* | Token logo as a publicly accessible URL. Mutually exclusive with --image. One of the two is required. |
--slippage | No* | Slippage tolerance, e.g. 0.01 = 1%. Mutually exclusive with --auto-slippage — provide one or the other. |
--auto-slippage | No* | Enable automatic slippage. Mutually exclusive with --slippage. |
--website | No | Project website URL |
--twitter | No | Twitter / X URL |
--telegram | No | Telegram group URL |
--priority-fee | No | Priority fee in SOL (SOL only, ≥ 0.0001 SOL) |
--tip-fee | No | Tip fee (SOL ≥ 0.00001 / BSC ≥ 0.000001 BNB; ignored on ETH/BASE) |
--gas-price | No | Gas price in wei (EVM chains) |
--anti-mev | No | Enable anti-MEV protection |
* --image or --image-url: provide exactly one. --slippage or --auto-slippage: provide exactly one.
cooking create Response Fields| Field | Type | Description |
|---|---|---|
status | string | pending / confirmed / failed |
hash | string | Transaction hash (may be empty while pending) |
order_id | string | Order ID — pass to gmgn-cli order get to poll for final status |
error_code | string | Error code on failure |
error_status | string | Error description on failure |
Token creation is asynchronous. If the initial cooking create response shows status: pending:
gmgn-cli order get every 2 seconds, up to 30 seconds:
gmgn-cli order get --chain <chain> --order-id <order_id>
output_token field of the order get response — it is NOT returned by cooking create directly.status is confirmed, failed, or expired.confirmed: display output_token as the token address and include the block explorer link.failed / expired: report the error_status and do not retry automatically.# Get token creation statistics per launchpad
gmgn-cli cooking stats
# Create a token on Pump.fun (SOL) — with URL image
gmgn-cli cooking create \
--chain sol \
--dex pump \
--from <wallet_address> \
--name "My Token" \
--symbol MAT \
--buy-amt 0.01 \
--image-url https://example.com/logo.png \
--slippage 0.01 \
--priority-fee 0.001
# Create a token on PancakeSwap (BSC) — with URL image and social links
gmgn-cli cooking create \
--chain bsc \
--dex pancakeswap \
--from <wallet_address> \
--name "BSC Token" \
--symbol BSCT \
--buy-amt 0.05 \
--image-url https://example.com/logo.png \
--slippage 0.02 \
--gas-price 5000000000 \
--website https://mytoken.io \
--twitter https://twitter.com/mytoken
# Create a token on FourMeme (BSC) — using base64 image from local file
gmgn-cli cooking create \
--chain bsc \
--dex fourmeme \
--from <wallet_address> \
--name "Four Token" \
--symbol FOUR \
--buy-amt 0.05 \
--image "$(base64 -i /path/to/logo.png)" \
--auto-slippage
# Create a token on letsbonk (SOL)
gmgn-cli cooking create \
--chain sol \
--dex letsbonk \
--from <wallet_address> \
--name "Bonk Token" \
--symbol BNKT \
--buy-amt 0.01 \
--image-url https://example.com/logo.png \
--auto-slippage \
--anti-mev
Before every cooking create, present this summary and wait for explicit user confirmation:
⚠️ Token Creation Confirmation Required
Chain: {chain}
Platform: {--dex} (e.g. pump / fourmeme)
Wallet: {--from}
Token Name: {--name}
Symbol: {--symbol}
Initial Buy: {--buy-amt} {native currency} (e.g. 0.01 SOL)
Slippage: {--slippage}% (or "auto")
Image: {--image-url or "base64 provided"}
Social: {twitter / telegram / website if provided}
Reply "confirm" to deploy this token. This action is IRREVERSIBLE.
After polling confirms a successful deployment:
✅ Token Created
Token: {--name} ({--symbol})
Address: {output_token from order get}
Chain: {chain}
Platform: {--dex}
Tx: {explorer link for hash}
Order ID: {order_id}
Block explorer links:
| Chain | Explorer |
|---|---|
| sol | https://solscan.io/tx/<hash> |
| bsc | https://bscscan.com/tx/<hash> |
| base | https://basescan.org/tx/<hash> |
| eth | https://etherscan.io/tx/<hash> |
When a user says they want to launch / create / deploy a token but has not provided all required information, collect information one required field at a time — never bundle multiple required fields into a single question. The user should be able to reply with a single value, not a labeled list.
Ask each required field as a short, direct question. Wait for the answer before moving to the next. Optional fields are grouped into one question after all required fields are collected.
Ask: "Which chain and platform?"
Show the options concisely:
| Chain | Platform | --dex |
|---|---|---|
| Solana | Pump.fun | pump |
| Solana | letsbonk | letsbonk |
| Solana | Raydium | raydium |
| Solana | BAGS | bags |
| Solana | Memoo | memoo |
| Solana | Bonkers | bonkers |
| BSC | FourMeme | fourmeme |
| BSC | PancakeSwap | pancakeswap |
| BSC | Flap | flap |
| Base | Clanker | clanker |
| Base | Zora | zora |
| Base | Flaunch | flaunch |
| Base | Virtuals | virtuals_v2 |
If the user is unsure, recommend: Pump.fun (SOL) or FourMeme (BSC).
Ask: "Token name?"
Wait for the user's reply (e.g. Doge Killer).
Ask: "Ticker symbol?"
Wait for the user's reply (e.g. DOGEK). Typically 3–8 uppercase characters.
Ask: "Logo image? (file path or URL — skip to launch without one)"
base64 -i <path> and pass the result to --image. Do not mention "base64" to the user.--image-url directly.Ask: "How much {SOL / BNB / ETH} for the initial buy?"
Pass the user's answer directly to --buy-amt — already in full token units (e.g. 0.01 = 0.01 SOL). Do NOT convert to lamports or wei.
Ask all optional fields together in one message:
"Any optional extras? (skip any you don't need)"
The user can reply with just the ones they have, or say "skip" / "none" to proceed.
Once all information is collected, present the pre-create confirmation summary (see Output Format section) and wait for the user to reply "confirm" before executing.
cooking create, present the full summary above and receive explicit "confirm" from the user. No exceptions. Do NOT auto-create.--dex validation — Before running, look up the user's named platform in the Supported Launchpads table and resolve to the correct --dex identifier. Never guess or pass a freeform platform name. If the chain/platform combination is not in the table, tell the user it is unsupported.--slippage or --auto-slippage must be provided. If the user did not specify, suggest --auto-slippage for volatile new tokens or ask for a preference.base64 -i <path> and pass the result to --image. If they provide a URL, use --image-url. If neither is provided, ask before building the confirmation — most platforms require a logo.--from wallet address format before submitting:
sol: base58, 32–44 charactersbsc / base / eth: 0x + 40 hex digitscooking create, if status is pending, poll order get every 2 seconds up to 30 seconds. The token address is in output_token. Do not report success until status is confirmed.GMGN_API_KEY and GMGN_PRIVATE_KEY can execute real transactions. Never log, display, or expose these values.cooking create uses critical auth (API Key + signature) — CLI handles signing automatically.cooking stats uses normal auth (API Key only — no private key needed).output_token from gmgn-cli order get, not in the initial cooking create response.--raw on any command to get single-line JSON for further processing.| Skill | Description |
|---|---|
| gmgn-swap | Contains order get command used for polling token creation status |
| gmgn-token | Token security check, info, holders, and traders — useful after launch to monitor your token |
| gmgn-market | market trenches for tracking bonding curve progress; market trending to see if your token is gaining traction |
| gmgn-track | Smart money and KOL trade tracking — monitor whether smart wallets are buying your token after launch |
| gmgn-portfolio | Wallet holdings and P&L — check your own wallet balance before deciding on --buy-amt |