GMGN Skill Cooking

> - Tax distribution: whenever the tax rate > 0, mkt_bps + deflation_bps + dividend_bps + lp_bps must sum to 10000. mkt_bps is the recipient's cut; the other three are burn / dividend / liquidity.

> - Recipient routing: set recipient_type = gift + twitter_account to send the recipient cut to an X handle, OR recipient_type = split + split_conf to send it to one or more addresses. Fill only the field that matches the chosen mode; leave the other empty ("" / []).

> - Use tax_rate for V5 (unified rate); use buy_tax_rate + sell_tax_rate for V6 (separate rates).

> - When lp_bps > 0: minimum_share_balance must be > 0.

FourMeme (--dex fourmeme)

fourmeme_rate_conf is passed via --fourmeme-rate-conf.

> fourmeme_user_login_sign, is_approve_allowance, is_raised_swap are broker/jobs internal fields — the public API does not accept them, so there is no flag. The multi-quote raise-token retry is handled server-side automatically (poll order get); the caller never sets these.

JSON schema for --fourmeme-rate-conf — single object:

> When fee_rate > 0: burn_rate + divide_rate + liquidity_rate + recipient_rate must sum to 100. When recipient_rate > 0: min_sharing must be > 0.

Auto-Sell Configuration

sell_configs is passed via --sell-configs as a JSON array. It schedules conditional sell orders to execute automatically once the token launch succeeds. Omit entirely for a standard launch with no auto-sell.

--sell-configs is a JSON array of CookingSellConfig objects:

Example: --sell-configs '[{"sell_type":"delay_sell","delay_sec":60,"sell_ratio":"0.5","wallet_addresses":[""]}]'

The buy/sell execution params for these CondMarket orders (slippage, fees, anti-MEV) can be tuned separately via --buy-trade-config / --sell-trade-config (TradeParam JSON). They do not affect the main creation tx, and fall back to the outer-level transaction flags when omitted.

> - check_price is total market cap in USD — e.g. "50000" triggers at a $50,000 market cap.

> - wallet_addresses may mix from_address and buy_wallets entries. The server creates signal_cooking for snipe wallets and pending_sell for main/bundle wallets automatically.

> - A wallet can carry multiple strategies (e.g. delay-sell 50%, then limit-sell the rest); each applies independently.

TradeParam (--buy-trade-config / --sell-trade-config)

These tune the execution params for the CondMarket buy/sell orders (bundle buys, sniper buys, and auto-sell). They do not affect the main creation transaction (the dev tx uses the outer-level --dev-* flags). When omitted, they fall back to the outer-level transaction flags.

--buy-trade-config / --sell-trade-config each accept a single JSON object:

Example: --buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}'

> A standard launch with no buyConfig sends {"is_anti_mev":false,"anti_mev_mode":"off"} and an empty buy_wallets list.

cooking create Response Fields

Status Polling

Token creation is asynchronous. If the initial cooking create response shows status: pending:

1. Poll with gmgn-cli order get every 2 seconds, up to 30 seconds:

```bash

gmgn-cli order get --chain --order-id

```

1. The new token's contract / mint address is in the report.output_token field of the order get response (only present when state = 30 and status = "successful") — it is NOT returned by cooking create directly.
2. Stop polling once status is confirmed, failed, or expired.
3. On confirmed: display output_token as the token address and include the block explorer link.
4. On failed / expired: report the error_status and do not retry automatically.

Usage Examples

Examples run shortest-first: basic single-launch commands, then full end-to-end configurations. Every JSON flag below is a valid payload shape — copy and adapt.

# 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 30 \
  --priority-fee 0.001

# Create a token on FourMeme (BSC) — base64 image + USD1 raise token
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 \
  --raised-token USD1

# Create a token on Bonk (SOL) with anti-MEV
gmgn-cli cooking create \
  --chain sol \
  --dex bonk \
  --from <wallet_address> \
  --name "Bonk Token" \
  --symbol BNKT \
  --buy-amt 0.01 \
  --image-url https://example.com/logo.png \
  --auto-slippage \
  --anti-mev

# Create on Pump.fun with auto-sell: sell 50% 60s after buy
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 \
  --auto-slippage \
  --sell-configs '[{"sell_type":"delay_sell","delay_sec":60,"sell_ratio":"0.5","wallet_addresses":["<wallet_address>"]}]'

These mirror real launch configurations end-to-end.

Pump.fun (SOL) — Bundle + Sniper + Auto-Sell + Agent Auto Buyback

gmgn-cli cooking create \
  --chain sol \
  --dex pump \
  --from DevWallet... \
  --name "Demo Coin" \
  --symbol DEMO \
  --buy-amt 0.5 \
  --image-url https://cdn.example.com/coin.png \
  --twitter https://x.com/handle/status/123 \
  --priority-fee 0.0005 \
  --tip-fee 0.0001 \
  --is-buy-back \
  --buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}' \
  --buy-wallets '[{"from_address":"Wallet1...","buy_amt":"0.1"},{"from_address":"Wallet2...","buy_amt":"0.1"}]' \
  --snip-buy-wallets '[{"from_address":"Sniper1...","buy_amt":"0.05"}]' \
  --sell-configs '[{"sell_type":"delay_sell","sell_ratio":"1","wallet_addresses":["Wallet1..."],"delay_mili_sec":5000}]'

• --is-buy-back is the Agent Auto Buyback mode (the backend also sets the agent fee internally).
• buy_amt values in --buy-wallets / --snip-buy-wallets are in native SOL.
• Bundle wallets ≤ 12, sniper wallets ≤ 10 on Pump.fun (see capability matrix).

FourMeme (BSC) — user fee split + raise token USDT

gmgn-cli cooking create \
  --chain bsc \
  --dex fourmeme \
  --from 0xDev... \
  --name "Demo BSC" \
  --symbol DBSC \
  --buy-amt 0.0123 \
  --image-url https://cdn.example.com/coin.png \
  --raised-token USDT \
  --website https://demo.com \
  --gas-price 1000000000 \
  --auto-slippage \
  --fourmeme-rate-conf '{"fee_rate":1,"recipient_rate":50,"burn_rate":20,"divide_rate":20,"liquidity_rate":10,"min_sharing":100000,"recipient_address":"0xDev..."}'

• --buy-amt 0.0123 is already converted to native BNB from the USDT amount the user wanted (see Quote Token conversion). Do the conversion before building the command.
• --gas-price 1000000000 is wei (1 Gwei).
• In --fourmeme-rate-conf, recipient_rate + burn_rate + divide_rate + liquidity_rate must sum to 100.

Flap (BSC) — split mode: route the recipient cut to a BSC address

gmgn-cli cooking create \
  --chain bsc \
  --dex flap \
  --from 0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d \
  --name "refer" \
  --symbol refer \
  --buy-amt 2 \
  --image-url https://gmgn.ai/external-res-va/11ad7747dcefcfaae87d3f53a4d7330d_v2l.webp \
  --website https://www.refercoins.bond/ \
  --twitter https://x.com/referdotfun \
  --dev-gas 50000000 \
  --auto-slippage \
  --flap-rate-conf '{"buy_tax_rate":100,"sell_tax_rate":100,"mkt_bps":10000,"deflation_bps":0,"dividend_bps":0,"lp_bps":0,"minimum_share_balance":10000,"recipient_type":"split","twitter_account":"","split_conf":[{"recipient":"0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d","bps":10000}]}'

• recipient_type: split → the recipient cut goes to split_conf addresses; twitter_account is left "".
• mkt_bps:10000 means the entire tax (1% buy / 1% sell) goes to the recipient — deflation_bps + dividend_bps + lp_bps are all 0, and the four still sum to 10000.
• split_conf has one address taking all 10000 bps (100%). Multiple addresses are allowed as long as their bps sum to 10000.

Flap (BSC) — gift mode: route the recipient cut to an X handle, split the rest across burn / dividend / LP

gmgn-cli cooking create \
  --chain bsc \
  --dex flap \
  --from 0x1f8d977b6843e1bbcb306c4a3664c9fb0277979d \
  --name "refer" \
  --symbol refer \
  --buy-amt 2 \
  --image-url https://gmgn.ai/external-res-va/11ad7747dcefcfaae87d3f53a4d7330d_v2l.webp \
  --website https://www.refercoins.bond/ \
  --twitter https://x.com/referdotfun \
  --dev-gas 50000000 \
  --auto-slippage \
  --flap-rate-conf '{"buy_tax_rate":100,"sell_tax_rate":100,"mkt_bps":5000,"deflation_bps":2700,"dividend_bps":1800,"lp_bps":500,"minimum_share_balance":10000,"recipient_type":"gift","twitter_account":"handleName","split_conf":[]}'

• recipient_type: gift → the recipient cut goes to the twitter_account X handle; split_conf is left [].
• Tax distribution: mkt_bps:5000 (50% to the handle) + deflation_bps:2700 (27% burn) + dividend_bps:1800 (18% dividend) + lp_bps:500 (5% LP) = 10000.
• lp_bps > 0, so minimum_share_balance must be > 0 (10000 here).

Output Format

Pre-create Confirmation

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}
Modes:        {Mayhem / Cashback / Agent Auto Buyback if set, else "none"}
Fee Share:    {recipient → % list if set, else "none"}
Auto-Sell:    {sell_configs summary if set, else "none"}

Reply "confirm" to deploy this token. This action is IRREVERSIBLE.

Omit the Modes / Fee Share / Auto-Sell lines if none were configured — or show them as none — but if any are set, they MUST appear here so the user re-confirms them explicitly.

Post-create Receipt

After polling confirms a successful deployment:

✅ Token Created

Token:    {--name} ({--symbol})
Address:  {report.output_token from order get}
Chain:    {chain}
Platform: {--dex}
Tx:       {explorer link for hash}
Order ID: {order_id}

Block explorer links:

Guided Launch Flow

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.

Step 1 — Chain & Platform

Ask: "Which chain and platform?"

Show the options concisely:

If the user is unsure, recommend: Pump.fun (SOL) or FourMeme (BSC).

The chosen platform determines which advanced options are available later in Step 7 (e.g. Mayhem/Cashback/Agent Auto Buyback on Pump.fun, fee-share splits on BAGS/Flap/FourMeme). Note the platform now; do not ask about advanced options yet.

Step 2 — Token Name

Ask: "Token name?"

Wait for the user's reply (e.g. Doge Killer).

Step 3 — Token Symbol

Ask: "Ticker symbol?"

Wait for the user's reply (e.g. DOGEK). Typically 3–8 uppercase characters.

Step 4 — Logo

Ask: "Logo image? (file path or URL — skip to launch without one)"

• File path → silently run base64 -i and pass the result to --image. Do not mention "base64" to the user.
• URL → use --image-url directly.
• Skip / none → proceed without a logo. Note that most platforms accept this, but it reduces visibility.

Step 5 — Initial Buy Amount

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.

Step 6 — Optional Details (single question)

Ask all optional fields together in one message:

"Any optional extras? (skip any you don't need)"

• Description — one-line pitch shown on the launchpad
• Twitter — Twitter / X URL
• Telegram — Telegram group URL
• Website — project website URL

The user can reply with just the ones they have, or say "skip" / "none" to proceed.

Step 7 — Platform Modes, Fees & Auto-Sell (platform-dependent)

After the basics are collected, ask once whether the user wants any advanced options for the platform they chose. Default everyone to a plain fair launch — only configure these when the user explicitly asks. Tailor the question to the selected platform; do not list options that don't apply to it.

Ask: "Want any advanced options, or launch with defaults? (reply 'defaults' to skip)" — then offer the relevant subset.

Phrase the question around the platform the user picked — only ask about modes that exist on that platform. For example, on Pump.fun ask specifically:

• "Enable Cashback mode?" (--is-cashback)
• "Enable Agent Auto Buyback mode?" (--is-buy-back)
• "Enable Mayhem mode?" (--is-mayhem)
• "Set up a fee-share split?" (--pump-fee-share-list)
• "Want me to remember these advanced settings for your next launch?" — if yes, save them to memory so future launches can pre-fill the same choices.

Bonk / BAGS / Flap / FourMeme have no mode toggles — for those, skip the mode questions and only ask about fee-share split and auto-sell.

The relevant options per platform:

• Pump.fun modes — Mayhem (--is-mayhem), Cashback (--is-cashback), Agent Auto Buyback (--is-buy-back).
• Fee-share split — Pump.fun (--pump-fee-share-list), BAGS (--dev-wallet-bps + --bags-fee-share-list), Bonk (--dev-wallet-bps), Flap (--flap-rate-conf), FourMeme (--fourmeme-rate-conf). See Advanced API Fields for JSON schemas. Warn the user this permanently routes token revenue to the listed accounts. Always ask the user for shares as percentages — convert to bps yourself. Shares must add up to 100%.
• Auto-sell — --sell-configs (JSON): delay-sell (sell a fraction N seconds after the buy) and/or limit-sell (sell once market cap hits a USD target). See Auto-Sell Configuration. Confirm the sell ratio and trigger before setting it.

If the user says "defaults" / "skip" / "none", proceed with none of these set.

Step 8 — Confirmation & Execute

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. If any advanced options from Step 7 were set, they MUST appear in the summary so the user re-confirms them explicitly.

Execution Guidelines

• [REQUIRED] Pre-create confirmation — Before executing cooking create, present the full summary above and receive explicit "confirm" from the user. No exceptions. Do NOT auto-create.
• [REQUIRED] --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 requirement — Either --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.
• Image handling — If the user provides a file path, run base64 -i 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.
• Fee-share / bps inputs — Always collect and confirm shares as percentages with the user; convert to basis points yourself (50% → 5000). Never ask for a raw bps value.
• Address validation — Validate --from wallet address format before submitting:
• sol: base58, 32–44 characters
• bsc / base: 0x + 40 hex digits
• Chain-wallet compatibility — SOL addresses are incompatible with EVM chains and vice versa. Warn the user and abort if the address format does not match the chain.
• Order polling — After cooking create, if status is pending, poll order get every 2 seconds up to 30 seconds. The token address is in report.output_token. Do not report success until status is confirmed.
• Credential sensitivity — GMGN_API_KEY and GMGN_PRIVATE_KEY can execute real transactions. Never log, display, or expose these values.

Notes

• cooking create uses signed auth (API Key + signature) — CLI handles signing automatically.
• cooking stats uses exist auth (API Key only — no private key needed).
• The new token's mint address is in report.output_token from gmgn-cli order get, not in the initial cooking create response.
• Use --raw on any command to get single-line JSON for further processing.

References