Gmgn Market

1---2name: gmgn-market3description: Get crypto and meme token price charts (K-line, candlestick, OHLCV), trending meme coin rankings by volume, and newly launched tokens on launchpads (pump.fun, fourmeme, letsbonk, Raydium, etc.) via GMGN API on Solana, BSC, or Base. Use when user asks for price chart, trending tokens, what's pumping, hot coins, new launches, token signals, or wants to discover early-stage opportunities.4argument-hint: "kline --chain <sol|bsc|base> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base> --interval <1m|5m|1h|6h|24h> | trenches --chain <sol|bsc|base> | signal --chain <sol|bsc>"5metadata:6  cliHelp: "gmgn-cli market --help"7---8 9**IMPORTANT: Always use `gmgn-cli` commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.**10 11**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.**12 13**⚠️ 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."**14 15Use the `gmgn-cli` tool to query K-line data for a token, browse trending tokens, or view Trenches token lists.16 17## Core Concepts18 19- **`--filter` chain defaults** — SOL and EVM chains have different default safety filters that are applied automatically when `--filter` is omitted. Do not assume the same defaults apply across chains:20  - **SOL**: defaults to `renounced frozen` (mint and freeze authority renounced)21  - **BSC / Base (EVM)**: defaults to `not_honeypot verified renounced`22  - Omitting `--filter` is NOT the same as "no filter" — the chain defaults are always applied. To use a custom filter set, explicitly specify all desired filter tags.23 24- **`volume` vs `amount` (kline)** — Naming is counterintuitive. `volume` = USD dollar value of trades; `amount` = token units traded. For a token priced at $0.0002, these differ by 5,000×. Always use `volume` for "how much USD was traded" and `amount` for "how many tokens changed hands."25 26- **`rug_ratio`** — A 0–1 score estimating rug pull likelihood. Values above `0.3` are high-risk. Do not treat as binary — combine with `top_10_holder_rate`, `dev_team_hold_rate`, and `is_honeypot` for a full picture.27 28- **`smart_degen_count` / `renowned_count`** — Number of platform-tagged smart money wallets (`smart_degen`) and KOL wallets (`renowned`) holding or trading this token. High values are bullish signals. These are GMGN-tagged wallet lists, not user-defined.29 30- **`hot_level`** — Trending intensity score. Higher = more actively traded right now. Not normalized — compare relative values within the same result set, not across time windows.31 32- **`renounced_mint` / `renounced_freeze_account`** — SOL-specific. Indicate whether the creator gave up the ability to mint more tokens or freeze wallets. Both being `1` is a safety baseline on Solana. Always `false` on EVM chains (concept does not apply).33 34- **`is_honeypot`** — EVM-specific (BSC / Base). Indicates whether the token contract prevents selling. Always empty/null on SOL — do not interpret an empty value as "not a honeypot" on Solana.35 36- **`creator_token_status`** — Dev holding status. `creator_hold` = dev still holds tokens (sell pressure risk). `creator_close` = dev has sold or burned their allocation (exit signal confirmed).37 38- **`cto_flag`** — Community Takeover flag. `1` = original dev abandoned the project and a community group took over marketing/development. Neutral to positive signal; evaluate in context.39 40- **Trenches categories** — Three lifecycle stages of launchpad tokens: `new_creation` (just created, still on bonding curve), `near_completion` (bonding curve nearly full, about to graduate), `completed` (graduated to open market / DEX). In the response, `near_completion` is always returned under the key `data.pump` regardless of the input `--type`.41 42- **`wash_trading` / `rat_trader_amount_rate` / `bundler_rate`** — Risk signals for artificial activity. `is_wash_trading` = coordinated fake volume detected. `rat_trader_amount_rate` = ratio of insider/sneak trading. `bundler_rate` = ratio of bot-bundled buys at launch. High values (> 0.3) suggest manipulated price action.43 44## Sub-commands45 46| Sub-command | Description |47|-------------|-------------|48| `market kline` | Token candlestick / OHLCV data and trading volume over a time range |49| `market trending` | Trending tokens ranked by swap activity — use `--interval` to specify the time window (e.g. `1m` for 1-minute hottest, `1h` for 1-hour trending) |50| `market trenches` | Newly launched launchpad platform tokens — **use this when the user asks for "new tokens", "just launched tokens", "latest tokens on pump.fun/letsbonk"**. Three categories: `new_creation` (just created), `near_completion` (bonding curve almost full), `completed` (graduated to open market / DEX) |51| `market signal` | Real-time token signal feed — price spikes, smart money buys, large buys, Dex ads, CTO events, and more. Results sorted by `trigger_at` descending. **sol / bsc only. Max 50 results per group.** |52 53## Supported Chains54 55`sol` / `bsc` / `base` (signal: `sol` / `bsc` only)56 57## Prerequisites58 59- `gmgn-cli` installed globally — if missing, run: `npm install -g gmgn-cli`60- `GMGN_API_KEY` configured in `~/.config/gmgn/.env`61 62## Rate Limit Handling63 64All market routes used by this skill go through GMGN's leaky-bucket limiter with `rate=10` and `capacity=10`. Sustained throughput is roughly `10 ÷ weight` requests/second, and the max burst is roughly `floor(10 ÷ weight)` when the bucket is full.65 66| Command | Route | Weight |67|---------|-------|--------|68| `market kline` | `GET /v1/market/token_kline` | 2 |69| `market trending` | `GET /v1/market/rank` | 1 |70| `market trenches` | `POST /v1/trenches` | 3 |71| `market signal` | `POST /v1/market/token_signal` | 3 |72 73When a request returns `429`:74 75- Read `X-RateLimit-Reset` from the response headers. It is a Unix timestamp in seconds that marks when the limit is expected to reset.76- If the response body contains `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.77- The CLI may wait and retry once automatically when the remaining cooldown is short. If it still fails, stop and tell the user the exact retry time instead of sending more requests.78- For `RATE_LIMIT_EXCEEDED` or `RATE_LIMIT_BANNED`, repeated requests during the cooldown can extend the ban by 5 seconds each time, up to 5 minutes. Do not spam retries.79 80**First-time setup** (if `GMGN_API_KEY` is not configured):81 821. Generate key pair and show the public key to the user:83   ```bash84   openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \85     openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null86   ```87   Tell the user: *"This is your Ed25519 public key. Go to **https://gmgn.ai/ai**, paste it into the API key creation form, then send me the API Key value shown on the page."*88 892. Wait for the user's API key, then configure:90   ```bash91   mkdir -p ~/.config/gmgn92   echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env93   chmod 600 ~/.config/gmgn/.env94   ```95 96## `market kline` Parameters97 98| Parameter | Required | Description |99|-----------|----------|-------------|100| `--chain` | Yes | `sol` / `bsc` / `base` |101| `--address` | Yes | Token contract address |102| `--resolution` | Yes | Candlestick resolution: `1m` / `5m` / `15m` / `1h` / `4h` / `1d` |103| `--from` | No | Start time (Unix seconds) |104| `--to` | No | End time (Unix seconds) |105 106## `market kline` Response Fields107 108The response is an object with a `list` array. Each element in `list` is one candlestick:109 110| Field | Type | Description |111|-------|------|-------------|112| `time` | number | Candle open time — Unix timestamp in **milliseconds** (divide by 1000 for seconds) |113| `open` | string | Opening price in USD at the start of the period |114| `close` | string | Closing price in USD at the end of the period |115| `high` | string | Highest price in USD during the period |116| `low` | string | Lowest price in USD during the period |117| `volume` | string | Trading volume in **USD** (dollar value of all trades in this period) |118| `amount` | string | Trading volume in **base token units** (number of tokens traded) |119 120**Important distinctions (naming is counterintuitive — do not guess):**121- `volume` = USD dollar value (e.g. `1214` means ~$1,214 traded) — use this for "how much was traded in USD"122- `amount` = token count (e.g. `5379110` means ~5.38M tokens changed hands) — use this for "how many tokens were traded"123- For tokens not priced at $1, `volume` and `amount` will differ by orders of magnitude (e.g. a $0.0002 token: $1,214 volume = 5,379,110 tokens)124- To get **total USD volume over a time range**, sum `volume` across all candles in the range125- To get **price trend**, read `close` values in chronological order (`time` ascending)126- To detect **volatility**, compare `high` vs `low` within each candle127- Candles are returned in chronological order (oldest first)128 129## `market trending` Options130 131**`--interval` selection guide — always match to the user's stated time window:**132 133| User says | `--interval` |134|-----------|-------------|135| "1m trending" / "hottest right now" | `1m` |136| "5m" / "5 minute" | `5m` |137| "1h" / "1 hour" / no time specified (default) | `1h` |138| "6h" / "6 hour" | `6h` |139| "24h" / "today" / "daily" | `24h` |140 141| Option | Description |142|--------|-------------|143| `--chain` | Required. `sol` / `bsc` / `base` |144| `--interval` | Required. `1m` / `5m` / `1h` / `6h` / `24h` (default `1h`) |145| `--limit <n>` | Number of results (default 100, max 100) |146| `--order-by <field>` | Sort field: `default` / `swaps` / `marketcap` / `history_highest_market_cap` / `liquidity` / `volume` / `holder_count` / `smart_degen_count` / `renowned_count` / `gas_fee` / `price` / `change1m` / `change5m` / `change1h` / `creation_timestamp` |147| `--direction <asc\|desc>` | Sort direction (default `desc`) |148| `--filter <tag...>` | Repeatable filter tags (chain-specific). **⚠️ SOL defaults: `renounced frozen`; BSC/Base defaults: `not_honeypot verified renounced`.** Omitting `--filter` is NOT "no filter" — chain defaults always apply. **sol** tags: `renounced` / `frozen` / `burn` / `token_burnt` / `has_social` / `not_social_dup` / `not_image_dup` / `dexscr_update_link` / `not_wash_trading` / `is_internal_market` / `is_out_market`. **evm** tags: `not_honeypot` / `verified` / `renounced` / `locked` / `token_burnt` / `has_social` / `not_social_dup` / `not_image_dup` / `dexscr_update_link` / `is_internal_market` / `is_out_market` |149| `--platform <name...>` | Repeatable platform filter (chain-specific). **sol**: `Pump.fun` / `pump_mayhem` / `pump_mayhem_agent` / `pump_agent` / `letsbonk` / `bonkers` / `bags` / `memoo` / `liquid` / `bankr` / `zora` / `surge` / `anoncoin` / `moonshot_app` / `wendotdev` / `heaven` / `sugar` / `token_mill` / `believe` / `trendsfun` / `trends_fun` / `jup_studio` / `Moonshot` / `boop` / `xstocks` / `ray_launchpad` / `meteora_virtual_curve` / `pool_ray` / `pool_meteora` / `pool_pump_amm` / `pool_orca`. **bsc**: `fourmeme` / `fourmeme_agent` / `bn_fourmeme` / `flap` / `clanker` / `lunafun` / `pool_uniswap` / `pool_pancake`. **base**: `clanker` / `bankr` / `flaunch` / `zora` / `zora_creator` / `baseapp` / `basememe` / `virtuals_v2` / `klik` |150 151## Usage Examples152 153### Kline154 155```bash156# Last 1 hour of 1-minute candles157# macOS:158gmgn-cli market kline \159  --chain sol \160  --address <token_address> \161  --resolution 1m \162  --from $(date -v-1H +%s) \163  --to $(date +%s)164# Linux: use $(date -d '1 hour ago' +%s) instead of $(date -v-1H +%s)165 166# Last 24 hours of 1-hour candles167# macOS:168gmgn-cli market kline \169  --chain sol \170  --address <token_address> \171  --resolution 1h \172  --from $(date -v-24H +%s) \173  --to $(date +%s)174# Linux: use $(date -d '24 hours ago' +%s) instead of $(date -v-24H +%s)175 176# Raw output for further processing177gmgn-cli market kline --chain sol --address <addr> \178  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'179```180 181### Trending — General182 183```bash184# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume185gmgn-cli market trending --chain sol --interval 1h --order-by volume --limit 20186 187# Top 50 tokens on SOL, 5m window, sorted by volume188gmgn-cli market trending --chain sol --interval 5m --order-by volume --limit 50189 190# Hot tokens with social links only, verified and not honeypot, on BSC over 24h191gmgn-cli market trending \192  --chain bsc --interval 24h \193  --filter has_social --filter not_honeypot --filter verified194```195 196### Trending — SOL by Launchpad Platform197 198Use `--platform` to filter trending results to tokens from specific launchpads only.199 200```bash201# SOL 1m hottest — Pump.fun + letsbonk only (most active launchpads), sorted by volume202gmgn-cli market trending \203  --chain sol --interval 1m \204  --platform Pump.fun --platform letsbonk \205  --order-by volume --limit 50 --raw206 207# SOL 5m hottest — Pump.fun + letsbonk + Moonshot, sorted by volume208gmgn-cli market trending \209  --chain sol --interval 5m \210  --platform Pump.fun --platform letsbonk --platform moonshot_app \211  --order-by volume --limit 50 --raw212 213# SOL 1h trending — Pump.fun only, with safety filters214gmgn-cli market trending \215  --chain sol --interval 1h \216  --platform Pump.fun \217  --filter renounced --filter frozen --filter not_wash_trading \218  --order-by volume --limit 20 --raw219 220# SOL 1h trending — all major launchpads combined221gmgn-cli market trending \222  --chain sol --interval 1h \223  --platform Pump.fun --platform letsbonk --platform moonshot_app \224  --platform pump_mayhem --platform pump_mayhem_agent --platform bonkers \225  --order-by volume --limit 50 --raw226```227 228### Trending — BSC by Launchpad Platform229 230```bash231# BSC 1m hottest — fourmeme (main BSC launchpad), sorted by volume232gmgn-cli market trending \233  --chain bsc --interval 1m \234  --platform fourmeme --platform four_xmode_agent \235  --order-by volume --limit 50 --raw236 237# BSC 5m hottest — fourmeme family, sorted by volume238gmgn-cli market trending \239  --chain bsc --interval 5m \240  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \241  --order-by volume --limit 50 --raw242 243# BSC 1h trending — fourmeme with safety filters244gmgn-cli market trending \245  --chain bsc --interval 1h \246  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \247  --filter not_honeypot --filter verified \248  --order-by volume --limit 20 --raw249```250 251### Trending — Base by Launchpad Platform252 253```bash254# Base 1m hottest — clanker + zora (main Base launchpads), sorted by volume255gmgn-cli market trending \256  --chain base --interval 1m \257  --platform clanker --platform zora --platform zora_creator \258  --order-by volume --limit 50 --raw259 260# Base 5m hottest — clanker + zora + virtuals_v2 + flaunch, sorted by volume261gmgn-cli market trending \262  --chain base --interval 5m \263  --platform clanker --platform zora --platform zora_creator \264  --platform virtuals_v2 --platform flaunch \265  --order-by volume --limit 50 --raw266 267# Base 1h trending — all major launchpads with safety filters268gmgn-cli market trending \269  --chain base --interval 1h \270  --platform clanker --platform zora --platform zora_creator \271  --platform virtuals_v2 --platform flaunch --platform baseapp \272  --filter not_honeypot --filter verified \273  --order-by volume --limit 20 --raw274```275 276## `market trending` Response Fields277 278The response is `data.rank` — an array of rank items. Each item represents one token.279 280**Basic Info**281 282| Field | Description |283|-------|-------------|284| `address` | Token contract address |285| `symbol` / `name` | Token ticker and full name |286| `logo` | Token logo image URL |287| `chain` | Chain identifier |288| `total_supply` | Total token supply |289| `creator` | Creator wallet address |290| `launchpad_platform` | Launch/pool platform (e.g. `Pump.fun`, `letsbonk`, `pool_meteora`, `fourmeme`) |291| `exchange` | Current DEX (e.g. `meteora_damm_v2`, `raydium`, `pump_amm`) |292| `open_timestamp` | Open market listing time (Unix seconds) |293| `creation_timestamp` | Token creation time (Unix seconds) |294| `rank` | Position in this trending list (lower = hotter) |295| `hot_level` | Trending intensity level (higher = hotter) |296 297**Price & Market**298 299| Field | Description |300|-------|-------------|301| `price` | Current price in USD |302| `market_cap` | Market cap in USD (directly available — no calculation needed) |303| `liquidity` | Current liquidity in USD |304| `volume` | Trading volume in USD for the queried interval |305| `history_highest_market_cap` | All-time highest market cap in USD |306| `initial_liquidity` | Initial liquidity at token launch |307| `price_change_percent` | Price change % for the queried interval |308| `price_change_percent1m` | Price change % in last 1 minute |309| `price_change_percent5m` | Price change % in last 5 minutes |310| `price_change_percent1h` | Price change % in last 1 hour |311 312**Trading Activity**313 314| Field | Description |315|-------|-------------|316| `swaps` | Total swap count in the queried interval |317| `buys` / `sells` | Buy / sell count in the interval |318| `holder_count` | Number of unique token holders |319| `gas_fee` | Average gas fee per transaction |320 321**Security & Risk**322 323| Field | Chains | Description |324|-------|--------|-------------|325| `renounced_mint` | SOL | Mint authority renounced (`1` = yes, `0` = no) |326| `renounced_freeze_account` | SOL | Freeze authority renounced (`1` = yes, `0` = no) |327| `is_honeypot` | BSC / Base | Honeypot flag (`1` = yes, `0` = no) |328| `is_open_source` | all | Contract verified (`1` = yes, `0` = no) |329| `is_renounced` | all | Ownership renounced (`1` = yes, `0` = no) |330| `buy_tax` / `sell_tax` | all | Tax rate — empty string means `0` (no tax) |331| `burn_status` | all | Liquidity burn status (e.g. `"none"`, `"burn"`) |332| `top_10_holder_rate` | all | Top 10 wallets concentration (0–1) |333| `rug_ratio` | all | Rug pull risk score (0–1) |334| `is_wash_trading` | all | Wash trading detected (`true` / `false`) |335| `rat_trader_amount_rate` | all | Ratio of insider/sneak trading volume |336| `bundler_rate` | all | Ratio of bundle bot trading volume |337| `entrapment_ratio` | all | Entrapment trading ratio |338| `sniper_count` | all | Number of sniper wallets at launch |339| `bot_degen_count` / `bot_degen_rate` | all | Bot degen wallet count / ratio |340| `dev_team_hold_rate` | all | Dev team holding ratio |341| `top70_sniper_hold_rate` | all | Top 70 sniper current holding ratio |342| `lock_percent` | all | Liquidity lock percentage |343 344**Dev Status**345 346| Field | Description |347|-------|-------------|348| `creator_token_status` | Dev holding status: `creator_hold` (still holding) / `creator_close` (sold/closed) |349| `creator_close` | Boolean shorthand for `creator_token_status == creator_close` |350| `dev_token_burn_ratio` | Ratio of dev's tokens that have been burned |351 352**Smart Money**353 354| Field | Description |355|-------|-------------|356| `smart_degen_count` | Number of smart money wallets holding the token |357| `renowned_count` | Number of renowned / KOL wallets holding the token |358| `bluechip_owner_percentage` | Ratio of holders that are bluechip wallets (0–1) |359 360**Social**361 362| Field | Description |363|-------|-------------|364| `twitter_username` | Twitter / X username (not a full URL — prepend `https://x.com/` to get the link) |365| `website` | Project website URL |366| `telegram` | Telegram URL |367| `cto_flag` | Community takeover flag (`1` = CTO has occurred) |368 369**Dexscreener Marketing**370 371| Field | Description |372|-------|-------------|373| `dexscr_ad` | Dexscreener ad placed (`1` = yes) |374| `dexscr_update_link` | Social links updated on Dexscreener (`1` = yes) |375| `dexscr_trending_bar` | Paid for Dexscreener trending bar (`1` = yes) |376| `dexscr_boost_fee` | Dexscreener boost amount paid (0 = none) |377 378---379 380## Workflow: Discover Trading Opportunities via Trending381 382Full workflow for discovering market opportunities: [`docs/workflow-market-opportunities.md`](../../docs/workflow-market-opportunities.md)383 384Steps: fetch trending (50 results, safe filters) → AI multi-factor analysis (smart money, volume, momentum, liquidity, maturity) → present top 5 table with rationale → offer deep dive or swap.385 386When results contain interesting tokens, proceed to full token due diligence: [`docs/workflow-token-research.md`](../../docs/workflow-token-research.md)387 388**For new / launchpad tokens** (`market trenches`): apply the structured early project screening workflow that includes security check and smart money entry detection — [`docs/workflow-early-project-screening.md`](../../docs/workflow-early-project-screening.md)389 390**For a daily market overview** (user asks "what's the market like today", "give me a daily brief", "what is smart money buying today"): combine `market trending` + `market trenches` with `gmgn-track smartmoney` — [`docs/workflow-daily-brief.md`](../../docs/workflow-daily-brief.md)391 392## Token Quality Filter Criteria393 394When evaluating tokens returned from `market trending` or `market trenches`, apply these criteria to quickly separate high-quality opportunities from noise. Do not present raw results without filtering.395 396### Pass / Watch / Skip Criteria397 398| Signal | 🟢 Pass | 🟡 Watch | 🔴 Skip |399|--------|---------|---------|---------|400| `smart_degen_count` | ≥ 3 | 1–2 | 0 |401| `rug_ratio` | < 0.1 | 0.1–0.3 | > 0.3 |402| `creator_token_status` | `creator_close` | — | `creator_hold` |403| `is_wash_trading` | `false` | — | `true` → skip immediately |404| `top_10_holder_rate` | < 0.20 | 0.20–0.50 | > 0.50 |405| `liquidity` | > $50k | $10k–$50k | < $10k |406| `has_social` (or any social field present) | yes | — | no (weak signal only) |407 408**Quick disqualification rule:** If `rug_ratio > 0.3` OR `is_wash_trading = true` OR `is_honeypot = 1` → skip immediately, no further analysis needed.409 410**Strong buy signal combination:** `smart_degen_count ≥ 3` + `rug_ratio < 0.2` + `creator_close` + `is_wash_trading = false` + `liquidity > $50k` → high-quality opportunity, proceed to full token research.411 412For full due diligence on any token surfaced here: [`docs/workflow-token-research.md`](../../docs/workflow-token-research.md)413 414## Token Lifecycle Stage415 416Use field combinations to determine what stage a token is in. This affects how signals should be interpreted.417 418### Stage 1 — Early (New Born)419 420**Indicators:**421- `creation_timestamp` < 1 hour ago422- `hot_level` low or just starting to rise423- `smart_degen_count = 0`, `renowned_count = 0`424 425**Interpretation:** Too early for smart money signals. No on-chain track record. High risk, high potential reward. **Wait for Stage 2 confirmation before acting.** Only the most risk-tolerant traders enter here.426 427### Stage 2 — Breakout428 429**Indicators:**430- `smart_degen_count ≥ 3` AND rising431- Volume surging (compare `swaps_1h` vs `swaps_24h / 24` — significantly higher)432- `price_change_percent1h > 20%`433- `creator_token_status = creator_hold` is OK at this stage (dev hasn't distributed yet)434 435**Interpretation:** Strongest entry signal. Smart money is accumulating. Verify security before acting. This window is often short — act on confirmation, not anticipation.436 437### Stage 3 — Distribution438 439**Indicators:**440- `creator_token_status = creator_close` (dev has sold their allocation)441- `renowned_count` buying (late social signal — KOLs often enter after smart money)442- `smart_degen_count` plateauing or declining443- Volume still high but momentum slowing444 445**Interpretation:** Late stage entry. Smart money may be exiting into retail/KOL demand. Higher risk for new entries. If already holding from Stage 2, evaluate exit levels.446 447### Stage 4 — Decline448 449**Indicators:**450- Volume declining across all windows451- `holder_count` declining452- `rat_trader_amount_rate` high (insider/sneak trading dominating)453- `smart_degen_count = 0` or clearly declining454 455**Interpretation:** Avoid new entries entirely. If still holding, consider exiting. The opportunity has likely passed.456 457## `market trenches` Parameters458 459**Intent → `--type` mapping (always specify `--type` explicitly):**460 461| User intent | `--type` value |462|-------------|----------------|463| "new tokens", "just launched", "newly created", "latest tokens" | `new_creation` |464| "about to graduate", "near completion", "bonding curve almost full" | `near_completion` |465| "graduated tokens", "already on DEX", "open market tokens" | `completed` |466| No specific stage mentioned | omit `--type` (returns all three) |467 468| Parameter | Required | Description |469|-----------|----------|-------------|470| `--chain` | Yes | `sol` / `bsc` / `base` |471| `--type` | No | Categories to query, repeatable: `new_creation` / `near_completion` / `completed` (default: all three) |472| `--launchpad-platform` | No | Launchpad platform filter, repeatable (default: all platforms for the chain) |473| `--limit` | No | Max results per category, max 80 (default: 80) |474| `--filter-preset` | No | Named server-side filter preset: `safe` / `smart-money` / `strict` |475| `--sort-by` | No | Client-side sort per category: `smart_degen_count` / `renowned_count` / `volume_24h` / `volume_1h` / `swaps_24h` / `swaps_1h` / `rug_ratio` / `holder_count` / `usd_market_cap` / `created_timestamp` |476| `--direction` | No | Sort direction: `asc` / `desc` (default: `desc`; `asc` for `rug_ratio`) |477| `--min-*` / `--max-*` | No | Server-side filter range flags — see Filter Fields Reference below |478 479### Filter Presets480 481Presets are applied server-side: the API filters tokens before returning results.482 483| Preset | Server-side filters applied |484|--------|----------------------------|485| `safe` | `max_rug_ratio=0.3` + `max_bundler_rate=0.3` + `max_insider_ratio=0.3` |486| `smart-money` | `min_smart_degen_count=1` |487| `strict` | `max_rug_ratio=0.3` + `max_bundler_rate=0.3` + `max_insider_ratio=0.3` + `min_smart_degen_count=1` + `min_volume_24h=1000` |488 489**Preset + explicit flag interaction:** Explicit filter flags always override preset values. For example, `--filter-preset safe --max-rug-ratio 0.1` applies the `safe` preset but overrides rug_ratio threshold to `0.1`.490 491**All filter flags are sent as part of the API request body (server-side)** — the server filters tokens before returning results. Use `--limit 80` (the default maximum) to maximise the pool.492 493Response fields: `data.new_creation`, `data.pump`, `data.completed` — each is an array of `RankItem` (same fields as `market trending` rank items). **Important: `data.pump` in the response corresponds to `--type near_completion` in the request. The API always returns this category under the key `pump`, not `near_completion`.**494 495### Server-Side Filter Fields496 497All filter flags are sent as part of the API request body — the server filters tokens before returning results. Flags follow the naming convention `--min-{field}` / `--max-{field}`.498 499| Flag pair | Type | Description |500|-----------|------|-------------|501| `--min-volume-24h` / `--max-volume-24h` | float | 24h trading volume (USD) |502| `--min-net-buy-24h` / `--max-net-buy-24h` | float | 24h net buy volume (USD) |503| `--min-swaps-24h` / `--max-swaps-24h` | int | 24h total swap count |504| `--min-buys-24h` / `--max-buys-24h` | int | 24h buy count |505| `--min-sells-24h` / `--max-sells-24h` | int | 24h sell count |506| `--min-visiting-count` / `--max-visiting-count` | int | Visitor count |507| `--min-progress` / `--max-progress` | float | Bonding curve progress (0–1) |508| `--min-marketcap` / `--max-marketcap` | float | Market cap (USD) |509| `--min-liquidity` / `--max-liquidity` | float | Liquidity (USD) |510| `--min-created` / `--max-created` | string | Token age (e.g. `1m` / `5m` / `1h` / `24h`) |511| `--min-holder-count` / `--max-holder-count` | int | Holder count |512| `--min-top-holder-rate` / `--max-top-holder-rate` | float | Top-10 holder concentration (0–1) |513| `--min-rug-ratio` / `--max-rug-ratio` | float | Rug pull risk score (0–1) |514| `--min-bundler-rate` / `--max-bundler-rate` | float | Bundle-bot trading ratio (0–1) |515| `--min-insider-ratio` / `--max-insider-ratio` | float | Insider trading ratio (0–1) |516| `--min-entrapment-ratio` / `--max-entrapment-ratio` | float | Entrapment/Phishing trading ratio (0–1) |517| `--min-private-vault-hold-rate` / `--max-private-vault-hold-rate` | float | Private vault holding ratio (0–1) |518| `--min-top70-sniper-hold-rate` / `--max-top70-sniper-hold-rate` | float | Top-70 sniper holding ratio (0–1) |519| `--min-bot-count` / `--max-bot-count` | int | Bot wallet count |520| `--min-bot-degen-rate` / `--max-bot-degen-rate` | float | Bot-degen wallet ratio (0–1) |521| `--min-fresh-wallet-rate` / `--max-fresh-wallet-rate` | float | Fresh wallet ratio (0–1) |522| `--min-total-fee` / `--max-total-fee` | float | Total fee |523| `--min-smart-degen-count` / `--max-smart-degen-count` | int | Smart-money holder count |524| `--min-renowned-count` / `--max-renowned-count` | int | KOL / renowned wallet count |525| `--min-creator-balance-rate` / `--max-creator-balance-rate` | float | Creator holding ratio (0–1) |526| `--min-creator-created-count` / `--max-creator-created-count` | int | Creator's total token creation count |527| `--min-creator-created-open-count` / `--max-creator-created-open-count` | int | Creator's graduated token count |528| `--min-creator-created-open-ratio` / `--max-creator-created-open-ratio` | float | Creator's graduation ratio (0–1) |529| `--min-x-follower` / `--max-x-follower` | int | Twitter / X follower count |530| `--min-twitter-rename-count` / `--max-twitter-rename-count` | int | Twitter rename count |531| `--min-tg-call-count` / `--max-tg-call-count` | int | Telegram call count |532 533### Trenches Filter Examples534 535```bash536# Apply the safe preset (server-side)537gmgn-cli market trenches --chain sol --type new_creation --filter-preset safe538 539# Require at least 1 smart money holder (server-side)540gmgn-cli market trenches --chain sol --type new_creation --min-smart-degen-count 1541 542# Safe preset + require smart money + sort by smart degen count (server-side filter, client-side sort)543gmgn-cli market trenches --chain sol --type new_creation \544  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count545 546# Strict preset — safe + smart money + min $1k volume (server-side)547gmgn-cli market trenches --chain sol --type new_creation --type near_completion \548  --filter-preset strict --sort-by smart_degen_count549 550# Manual range filters (all sent server-side)551gmgn-cli market trenches --chain sol --type new_creation \552  --max-rug-ratio 0.3 --max-bundler-rate 0.3 --max-insider-ratio 0.3 \553  --min-smart-degen-count 1 --min-volume-24h 1000554 555# Filter by token age: only tokens created within the last 30 minutes556gmgn-cli market trenches --chain sol --type new_creation --max-created 30m557 558# Filter by market cap range559gmgn-cli market trenches --chain sol --type new_creation \560  --min-marketcap 10000 --max-marketcap 500000561```562 563## `market trenches` Response Fields564 565**Basic Info**566 567| Field | Description |568|-------|-------------|569| `address` | Token contract address |570| `symbol` / `name` | Token symbol and name |571| `launchpad_platform` | Launch platform (e.g. `Pump.fun`, `letsbonk`) |572| `exchange` | Current exchange (e.g. `pump_amm`, `raydium`) |573| `usd_market_cap` | Market cap in USD |574| `liquidity` | Liquidity in USD |575| `total_supply` | Total token supply |576| `created_timestamp` | Creation time (Unix seconds) |577| `open_timestamp` | Open market listing time (Unix seconds, `completed` only) |578| `complete_timestamp` | Bonding curve completion time (Unix seconds) |579| `complete_cost_time` | Time from creation to completion in seconds |580 581**Trading Data**582 583| Field | Description |584|-------|-------------|585| `swaps_1m` / `swaps_1h` / `swaps_24h` | Swap count per time window |586| `volume_1h` / `volume_24h` | Trading volume in USD |587| `buys_24h` / `sells_24h` | Buy / sell count in 24h |588| `net_buy_24h` | Net buy volume in 24h |589| `holder_count` | Number of token holders |590 591**Security & Risk**592 593| Field | Chains | Description |594|-------|--------|-------------|595| `renounced_mint` | SOL | Whether mint authority is renounced (SOL-specific concept; always `false` on EVM chains) |596| `renounced_freeze_account` | SOL | Whether freeze authority is renounced (SOL-specific concept; always `false` on EVM chains) |597| `burn_status` | all | Liquidity burn status |598| `rug_ratio` | all | Rug pull risk ratio |599| `top_10_holder_rate` | all | Top 10 holders concentration ratio |600| `rat_trader_amount_rate` | all | Insider / sneak trading volume ratio |601| `bundler_trader_amount_rate` | all | Bundle trading volume ratio |602| `is_wash_trading` | all | Whether wash trading is detected |603| `sniper_count` | all | Number of sniper wallets |604| `suspected_insider_hold_rate` | all | Suspected insider holding ratio |605| `open_source` | all | Whether contract source code is verified (`"yes"` / `"no"` / `"unknown"`) |606| `owner_renounced` | all | Whether contract ownership is renounced (`"yes"` / `"no"` / `"unknown"`) |607| `is_honeypot` | BSC / Base | Whether token is a honeypot (`"yes"` / `"no"`); returns empty string on SOL (not applicable) |608| `buy_tax` | all | Buy tax ratio (e.g. `0.03` = 3%) |609| `dev_team_hold_rate` | all | Dev team holding ratio |610 611**Dev Holdings**612 613| Field | Description |614|-------|-------------|615| `creator_token_status` | Dev holding status (e.g. `creator_hold`, `creator_close`) |616| `creator_balance_rate` | Dev holding ratio as a proportion of total supply |617 618**Smart Money**619 620| Field | Description |621|-------|-------------|622| `smart_degen_count` | Number of smart money holders |623| `renowned_count` | Number of renowned wallet holders (KOL) |624 625**Social Media**626 627| Field | Description |628|-------|-------------|629| `twitter` | Twitter / X link |630| `telegram` | Telegram link |631| `website` | Website link |632| `instagram` | Instagram link |633| `tiktok` | TikTok link |634| `has_at_least_one_social` | Whether any social media link exists |635| `x_user_follower` | Twitter follower count |636| `cto_flag` | Whether community takeover (CTO) has occurred |637 638**Dexscreener Marketing**639 640| Field | Description |641|-------|-------------|642| `dexscr_ad` | Whether a Dexscreener ad has been placed |643| `dexscr_update_link` | Whether social links have been updated on Dexscreener |644| `dexscr_trending_bar` | Whether paid for Dexscreener trending bar placement |645| `dexscr_boost_fee` | Amount paid for Dexscreener boost (0 = none) |646 647**After fetching trenches results, apply the Token Quality Filter Criteria section before presenting tokens to the user.** Do not dump raw results — filter first, then surface the strongest candidates.648 649### Trenches Filter Examples650 651```bash652# Quick safe screen — exclude rugs, wash trading, and bundlers653gmgn-cli market trenches --chain sol --type new_creation \654  --filter-preset safe --raw655 656# Smart money screen — only tokens with smart money or KOL presence657gmgn-cli market trenches --chain sol \658  --type new_creation --type near_completion \659  --filter-preset smart-money \660  --sort-by smart_degen_count --raw661 662# Strict screen — safe + smart money + minimum volume, sorted by smart degens663gmgn-cli market trenches --chain sol --type completed \664  --filter-preset strict --sort-by smart_degen_count --raw665 666# Custom filter — no wash trading, rug_ratio <= 0.2, at least 1 smart degen667gmgn-cli market trenches --chain sol \668  --type new_creation --type near_completion \669  --exclude-wash-trading --max-rug-ratio 0.2 --min-smart-degen 1 \670  --sort-by smart_degen_count --raw671 672# BSC — safe screen on new tokens from fourmeme673gmgn-cli market trenches --chain bsc --type new_creation \674  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent \675  --filter-preset safe --sort-by volume_1h --raw676 677# Sort by rug_ratio ascending (safest first), no other filters678gmgn-cli market trenches --chain sol --type completed \679  --sort-by rug_ratio --raw680 681# Find tokens with many holders and strong 1h swap activity682gmgn-cli market trenches --chain sol --type completed \683  --min-holders 100 --min-swaps 50 \684  --sort-by swaps_1h --raw685```686 687### Solana Trenches Examples688 689```bash690# All three categories at once691gmgn-cli market trenches --chain sol --raw \692  --type new_creation --type near_completion --type completed \693  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \694  --limit 80695 696# New creation only697gmgn-cli market trenches --chain sol --raw \698  --type new_creation \699  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \700  --limit 80701 702# Near completion only703gmgn-cli market trenches --chain sol --raw \704  --type near_completion \705  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \706  --limit 80707 708# Completed (open market) only709gmgn-cli market trenches --chain sol --raw \710  --type completed \711  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \712  --limit 80713```714 715### BSC Trenches Examples716 717```bash718# All three categories at once719gmgn-cli market trenches --chain bsc --raw \720  --type new_creation --type near_completion --type completed \721  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \722  --limit 80723 724# New creation only725gmgn-cli market trenches --chain bsc --raw \726  --type new_creation \727  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \728  --limit 80729 730# Near completion only731gmgn-cli market trenches --chain bsc --raw \732  --type near_completion \733  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \734  --limit 80735 736# Completed (open market) only737gmgn-cli market trenches --chain bsc --raw \738  --type completed \739  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \740  --limit 80741```742 743### Base Trenches Examples744 745```bash746# All three categories at once747gmgn-cli market trenches --chain base --raw \748  --type new_creation --type near_completion --type completed \749  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \750  --limit 80751 752# New creation only753gmgn-cli market trenches --chain base --raw \754  --type new_creation \755  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \756  --limit 80757 758# Near completion only759gmgn-cli market trenches --chain base --raw \760  --type near_completion \761  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \762  --limit 80763 764# Completed (open market) only765gmgn-cli market trenches --chain base --raw \766  --type completed \767  --launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \768  --limit 80769```770 771## Output Format772 773### `market kline` — Price Summary774 775After fetching candles, present a brief price analysis. Do not dump raw candle arrays.776 777```778{symbol} — {resolution} chart ({from} → {to})779Open: ${open of first candle}  |  Close: ${close of last candle}  |  Range: ${min low} – ${max high}780Total volume: ${sum of all volume fields} USD781Trend: [brief description — e.g. "steady uptrend", "sharp drop then recovery", "sideways"]782```783 784### `market trending` — Top Tokens Table785 786Present the top results (default: top 10, or as requested) as a table:787 788```789# | Symbol | Price | MCap | Volume ({interval}) | 1h Chg | SM | Liq | Platform | Signal790```791 792Where **Signal** = quality flag derived from the token's data:793- 🟢 Pass: `smart_degen_count ≥ 3` AND `rug_ratio < 0.2` AND `is_wash_trading = false`794- 🔴 Skip: `rug_ratio > 0.3` OR `is_wash_trading = true` OR `is_honeypot = 1`795- 🟡 Watch: everything else796 797Then give a one-line highlight for any standout tokens (e.g. "TOKEN1 has 12 smart money holders and +85% in 1h — 🟢 strong signal").798 799### `market trenches` — Grouped by Category800 801Present each category separately with a header:802 803```804🆕 New Creation ({count} tokens)805# | Symbol | Created | Liquidity | Swaps (1h) | Smart Degens | Social806 807⏳ Near Completion ({count} tokens)808# | Symbol | Market Cap | Swaps (1h) | Smart Degens | Social809 810✅ Graduated ({count} tokens)811# | Symbol | Market Cap | Volume (1h) | Smart Degens | Social812```813 814## `market signal` Parameters815 816Chains: `sol` / `bsc` only. **Maximum 50 results per group** — use multiple groups via `--groups` to cover different signal types in a single request.817 818**Single-group (individual flags):**819 820| Option | Required | Description |821|--------|----------|-------------|822| `--chain` | Yes | `sol` / `bsc` |823| `--signal-type` | No | Signal type(s), repeatable (1–18, default: all). See Signal Types below. |824| `--mc-min` | No | Min market cap at trigger time (USD) |825| `--mc-max` | No | Max market cap at trigger time (USD) |826| `--trigger-mc-min` | No | Min market cap at signal trigger moment (USD) |827| `--trigger-mc-max` | No | Max market cap at signal trigger moment (USD) |828| `--total-fee-min` | No | Min total fees paid (USD) |829| `--total-fee-max` | No | Max total fees paid (USD) |830| `--min-create-or-open-ts` | No | Min token creation or open timestamp (Unix seconds string) |831| `--max-create-or-open-ts` | No | Max token creation or open timestamp (Unix seconds string) |832 833**Multi-group override:**834 835Pass `--groups '<json_array>'` to query multiple filter groups in a single request. The upstream executes all groups in parallel and merges results sorted by `trigger_at` descending. When `--groups` is present, all individual flags above are ignored.836 837```bash838gmgn-cli market signal --chain sol \839  --groups '[{"signal_type":[12,14]},{"signal_type":[6,7],"mc_min":50000}]'840```841 842### Signal Types843 844| Value | Name | Description |845|-------|------|-------------|846| 1 | SignalType1 | General signal (K-line price spike) |847| 2 | SignalTypeDexAd | Dex ad placement |848| 3 | SignalTypeDexUpdateLink | Dex social link updated |849| 4 | SignalTypeDexTrendingBar | Dex trending bar |850| 5 | SignalTypeDexBoost | Dex Boost |851| 6 | SignalTypePriceUp | Price spike |852| 7 | SignalTypePriceATH | All-time high price |853| 8 | SignalTypeMcpKeyLevel | Market cap key level |854| 9 | SignalTypeLive | Live stream |855| 10 | SignalTypeBundlerSell | Bundler sell |856| 11 | SignalTypeCto | Community takeover (CTO) |857| 12 | SignalTypeSmartDegenBuy | Smart money buy |858| 13 | SignalTypePlatformCall | Platform call |859| 14 | SignalTypeLargeAmountBuy | Large amount buy |860| 15 | SignalTypeMultiBuy | Multiple buys |861| 16 | SignalTypeMultiLargeBuy | Multiple large buys |862| 17 | SignalTypeBagsClaims | Bags Claim |863| 18 | SignalTypePumpClaims | Pump Claim |864 865### `market signal` Response Fields866 867Each item in the response array is one signal event:868 869| Field | Type | Description |870|-------|------|-------------|871| `id` | string | Signal event ID |872| `token_address` | string | Token contract address |873| `signal_type` | number | Signal type (1–18, see Signal Types above) |874| `trigger_at` | number | Unix timestamp (seconds) when the signal was triggered |875| `trigger_mc` | number | Market cap at signal trigger time (USD) |876| `first_trigger_mc` | number | Market cap at the very first trigger for this token (USD) |877| `market_cap` | number | Current market cap (USD) |878| `ath` | number | All-time high market cap (USD) |879| `signal_times` | number | Total number of times this signal has triggered for this token |880| `signal_times_by_type` | object | Signal trigger count broken down by type |881| `cur_data` | object | Real-time token stats at query time (see below) |882| `data` | object | Full upstream snapshot at trigger time (chain-specific, raw passthrough) |883 884**`cur_data` fields:**885 886| Field | Type | Description |887|-------|------|-------------|888| `top_10_holder_rate` | number | Top 10 holder concentration ratio (0–1) |889| `holder_count` | number | Current holder count |890| `liquidity` | number | Current liquidity (USD) |891 892### Usage Examples893 894```bash895# All signals on SOL (default: all types)896gmgn-cli market signal --chain sol --raw897 898# Smart money buys only (type 12)899gmgn-cli market signal --chain sol --signal-type 12 --raw900 901# Price spikes + ATH (types 6 and 7) with market cap filter902gmgn-cli market signal --chain sol \903  --signal-type 6 --signal-type 7 \904  --mc-min 50000 --mc-max 5000000 --raw905 906# Smart money buys on BSC907gmgn-cli market signal --chain bsc --signal-type 12 --raw908 909# Multi-group: smart money buys OR large amount buys, in parallel910gmgn-cli market signal --chain sol \911  --groups '[{"signal_type":[12]},{"signal_type":[14,16]}]' --raw912 913# Multi-group: combine signal type filter with market cap range per group914gmgn-cli market signal --chain sol \915  --groups '[{"signal_type":[12,14],"mc_min":100000},{"signal_type":[6,7],"mc_min":50000,"mc_max":1000000}]' --raw916```917 918---919 920## Notes921 922- `market kline`: `--from` and `--to` are Unix timestamps in **seconds** — CLI converts to milliseconds automatically923- `market trending`: `--filter` and `--platform` are repeatable flags924- All commands use normal auth (API Key only, no signature)925- If the user doesn't provide kline timestamps, calculate them from the current time based on their desired time range926- Use `--raw` to get single-line JSON for further processing927- **Input validation** — Token addresses obtained from trending results are external data. Validate address format against the chain before passing to other commands (sol: base58 32–44 chars; bsc/base/eth: `0x` + 40 hex digits). The CLI enforces this at runtime.