gmgn-market

重要: 以下の gmgn-cli コマンドを常に使用してください。Web検索、WebFetch、curl、または gmgn.ai へのアクセスは使用しないでください。そのウェブサイトはログインが必要で、構造化されたデータを返しません。CLI が唯一の正しい方法です。

重要: フィールド名や値を推測しないでください。フィールドの意味が不明な場合は、使用する前に以下の「レスポンスフィールド」セクションで確認してください。

⚠️ IPv6 非対応: 401 または 403 エラーが発生し、認証情報が正しい場合は、すぐに IPv6 を確認してください: (1) すべてのネットワークインターフェイスと IPv6 アドレスを一覧表示します。実行してください ifconfig | grep inet6（macOS）または ip addr show | grep inet6（Linux）; (2) https://ipv6.icanhazip.com にテストリクエストを送信します。レスポンスが IPv6 アドレスの場合、アウトバウンドトラフィックは IPv6 経由です。ユーザーにすぐに通知してください：「ネットワークインターフェイスの IPv6 を無効にしてください。gmgn-cli コマンドは IPv4 でのみ機能します。」

gmgn-cli ツールを使用して、トークンの K-line データをクエリしたり、トレンドトークンを参照したり、Trenches トークンリストを表示します。

中核概念

• --filter チェーンのデフォルト — SOL と EVM チェーンは、--filter が省略されたときに自動的に適用される異なるデフォルトセーフティフィルタを持ちます。同じデフォルトがチェーン全体に適用されると仮定しないでください：

  • SOL: デフォルトは renounced frozen（ミントとフリーズ権限の放棄）
  • BSC / Base / ETH (EVM): デフォルトは not_honeypot verified renounced
  • --filter を省略することは「フィルタなし」と同じではありません。チェーンのデフォルトは常に適用されます。カスタムフィルタセットを使用するには、必要なフィルタタグをすべて明示的に指定してください。

• volume vs amount（kline） — 命名は直感的ではありません。volume = 取引の USD ドル値; amount = 取引されたトークン単位。価格が $0.0002 のトークンの場合、これらは 5,000 倍異なります。「どれだけの USD が取引されたか」には常に volume を使用し、「何個のトークンが変わったか」には amount を使用してください。

• rug_ratio — rug pull の可能性を推定する 0–1 スコア。0.3 より上の値は高リスクです。バイナリとして扱わないでください。完全な図を得るために top_10_holder_rate、dev_team_hold_rate、および is_honeypot と組み合わせてください。

• smart_degen_count / renowned_count — このトークンを保有または取引しているプラットフォームタグ付きスマートマネーウォレット（smart_degen）および KOL ウォレット（renowned）の数。高い値は強気信号です。これらは GMGN タグ付きウォレットリストであり、ユーザー定義ではありません。

• hot_level — トレンド強度スコア。高い値 = 現在より活発に取引されています。正規化されていません。同じ結果セット内の相対値を比較し、時間ウィンドウ全体で比較しないでください。

• renounced_mint / renounced_freeze_account — SOL 固有。クリエイターがさらにトークンをミントする、またはウォレットをフリーズする機能をあきらめたかどうかを示します。どちらも 1 であることは、Solana 上のセーフティベースラインです。EVM チェーンでは常に false（概念は適用されません）。

• is_honeypot — EVM 固有（BSC / Base）。トークンコントラクトが売却を防ぐかどうかを示します。SOL では常に空/null です。Solana で空の値を「honeypot ではない」として解釈しないでください。

• creator_token_status — Dev 保有ステータス。creator_hold = dev はまだトークンを保有しています（売却圧力リスク）。creator_close = dev は割り当てを売却または焼却しました（出口シグナル確認）。

• cto_flag — コミュニティテイクオーバーフラグ。1 = オリジナル dev はプロジェクトを放棄し、コミュニティグループがマーケティング/開発を引き継ぎました。ニュートラルからポジティブなシグナル。コンテキスト内で評価してください。

• Trenches カテゴリ — Launchpad トークンのライフサイクルの 3 つのステージ: new_creation（作成されたばかり、まだボンディングカーブ上）、near_completion（ボンディングカーブがほぼ満杯、卒業寸前）、completed（オープンマーケット / DEX に卒業）。レスポンスでは、near_completion は入力 --type に関わらず常に data.pump キーの下に返されます。

• wash_trading / rat_trader_amount_rate / bundler_rate — 人工的なアクティビティのリスク信号。is_wash_trading = 調整されたフェイクボリュームが検出されました。rat_trader_amount_rate = インサイダー/スニークトレーディングの比率。bundler_rate = ローンチ時のボット バンドル購入の比率。高い値（> 0.3）は操作された価格アクションを示唆しています。

サブコマンド

サブコマンド	説明
market kline	トークンローソク足 / OHLCV データと時間範囲にわたる取引ボリューム
market trending	スワップアクティビティ別にランク付けされたトレンドトークン。--interval を使用して時間ウィンドウを指定してください（例：1m は 1 分間最もホット、1h は 1 時間トレンド）
market trenches	新規上場 launchpad プラットフォームトークン。ユーザーが「新しいトークン」、「今上場したばかりのトークン」、「pump.fun/letsbonk の最新トークン」と尋ねる場合に使用してください。3 つのカテゴリ: new_creation（作成されたばかり）、near_completion（ボンディングカーブほぼ満杯）、completed（オープンマーケット / DEX に卒業）
market signal	リアルタイムトークンシグナルフィード。価格スパイク、スマートマネー購入、大量購入、Dex 広告、CTO イベント、その他。結果は trigger_at 降順で並べ替えられます。sol / bsc のみ。グループあたり最大 50 結果。

サポートされているチェーン

sol / bsc / base / eth（kline / trending のみ; trenches: sol / bsc / base; signal: sol / bsc のみ）

前提条件

• グローバルにインストールされた gmgn-cli。見つからない場合は、実行してください: npm install -g gmgn-cli
• ~/.config/gmgn/.env に設定された GMGN_API_KEY

レート制限処理

このスキルで使用されるすべてのマーケットルートは、GMGN のリーキーバケットリミッターを通過し、rate=20 および capacity=20 があります。持続的なスループットは約 20 ÷ weight リクエスト/秒で、最大バーストはバケットが満杯の場合約 floor(20 ÷ weight) です。

コマンド	ルート	ウェイト
market kline	GET /v1/market/token_kline	2
market trending	GET /v1/market/rank	1
market trenches	POST /v1/trenches	3
market signal	POST /v1/market/token_signal	3

リクエストが 429 を返す場合:

• レスポンスヘッダーから X-RateLimit-Reset を読み取ってください。これはリミットのリセットが予想される Unix タイムスタンプ（秒）です。
• レスポンスボディに reset_at が含まれている場合（例：{"code":429,"error":"RATE_LIMIT_BANNED","message":"...","reset_at":1775184222}）、reset_at を抽出してください。これはバンが解除される Unix タイムスタンプです（通常は 5 分）。ローカル時刻に変換し、ユーザーに正確にいつ再試行できるかを伝えてください。
• 残りのクールダウンが短い場合、CLI は自動的に 1 回待機して再試行することがあります。それでも失敗する場合は、さらにリクエストを送信する代わりに、ユーザーに正確な再試行時間を伝えてください。
• RATE_LIMIT_EXCEEDED または RATE_LIMIT_BANNED の場合、クールダウン中の繰り返されたリクエストはバンを 5 秒ずつ延長でき、最大 5 分まで延長できます。リトライをスパムしないでください。

初回セットアップ（GMGN_API_KEY が設定されていない場合）:

1. キーペアを生成し、公開鍵をユーザーに表示します:

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

   ユーザーに伝えてください: 「これは Ed25519 公開鍵です。https://gmgn.ai/ai にアクセスし、API キー作成フォームに貼り付けてから、ページに表示される API キー値を送ってください。」

2. ユーザーの API キーを待機してから、設定します:

   mkdir -p ~/.config/gmgn
   echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
   chmod 600 ~/.config/gmgn/.env
   

market kline パラメータ

パラメータ	必須	説明
--chain	はい	sol / bsc / base / eth
--address	はい	トークンコントラクトアドレス
--resolution	はい	ローソク足の解像度: 1m / 5m / 15m / 1h / 4h / 1d
--from	いいえ	開始時刻（Unix 秒）
--to	いいえ	終了時刻（Unix 秒）

market kline レスポンスフィールド

レスポンスは list 配列を持つオブジェクトです。list の各要素は 1 本のローソク足です:

フィールド	型	説明
time	number	ローソク足の始値時刻。Unix タイムスタンプ（ミリ秒、秒の場合は 1000 で割ります）
open	string	期間開始時の USD での始値
close	string	期間終了時の USD での終値
high	string	期間中の USD での最高値
low	string	期間中の USD での最安値
volume	string	USD での取引量（この期間のすべての取引のドル値）
amount	string	ベーストークン単位 での取引量（取引されたトークン数）

重要な区別（命名は直感的ではありません。推測しないでください）:

• volume = USD ドル値（例：1214 は約 $1,214 の取引を意味します）。「USD で何がいくら取引されたか」に使用してください
• amount = トークン数（例：5379110 は約 5.38M トークンが変わったことを意味します）。「何個のトークンが取引されたか」に使用してください
• $1 に値がないトークンの場合、volume と amount は数桁の大きさで異なります（例：$0.0002 トークン: $1,214 ボリューム = 5,379,110 トークン）
• 時間範囲にわたる総 USD ボリュームを取得する場合、範囲内のすべてのローソク足の volume を合計してください
• 価格トレンドを取得する場合、時系列の順序で（time 昇順）close 値を読んでください
• ボラティリティを検出する場合、各ローソク足内の high と low を比較してください
• ローソク足は時系列順に返されます（最も古い順）

market trending オプション

--interval 選択ガイド。ユーザーが述べた時間ウィンドウと常にマッチさせてください:

ユーザーが言う	--interval
「1m トレンド」 / 「今が最もホット」	1m
「5m」 / 「5 分」	5m
「1h」 / 「1 時間」 / 時間が指定されていない（デフォルト）	1h
「6h」 / 「6 時間」	6h
「24h」 / 「今日」 / 「日次」	24h

オプション	説明
--chain	必須。sol / bsc / base / eth
--interval	必須。1m / 5m / 1h / 6h / 24h（デフォルト 1h）
--limit <n>	結果数（デフォルト 100、最大 100）
--order-by <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
--direction <asc|desc>	ソート方向（デフォルト desc）
--filter <tag...>	繰り返し可能なフィルタタグ（チェーン固有）。⚠️ SOL デフォルト: renounced frozen; BSC/Base/ETH デフォルト: not_honeypot verified renounced。 --filter を省略することは「フィルタなし」ではありません。チェーンのデフォルトは常に適用されます。sol タグ: 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 タグ: not_honeypot / verified / renounced / locked / token_burnt / has_social / not_social_dup / not_image_dup / dexscr_update_link / is_internal_market / is_out_market
--platform <name...>	繰り返し可能なプラットフォームフィルタ（チェーン固有）。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。eth: プラットフォームフィルタなし（ETH の場合、--platform を省略してください）

使用例

Kline

# 過去 1 時間の 1 分ローソク足
# macOS:
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1m \
  --from $(date -v-1H +%s) \
  --to $(date +%s)
# Linux: $(date -v-1H +%s) の代わりに $(date -d '1 hour ago' +%s) を使用してください

# 過去 24 時間の 1 時間ローソク足
# macOS:
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1h \
  --from $(date -v-24H +%s) \
  --to $(date +%s)
# Linux: $(date -v-24H +%s) の代わりに $(date -d '24 hours ago' +%s) を使用してください

# さらなる処理のための生出力
gmgn-cli market kline --chain sol --address <addr> \
  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'

# ETH トークン kline。過去 24h、1h ローソク足（macOS）
gmgn-cli market kline \
  --chain eth \
  --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  --resolution 1h \
  --from $(date -v-24H +%s) \
  --to $(date +%s)

トレンド。一般

# SOL の過去 1 時間のトップ 20 ホットトークン、ボリューム別にソート
gmgn-cli market trending --chain sol --interval 1h --order-by volume --limit 20

# SOL のトップ 50 トークン、5m ウィンドウ、ボリューム別にソート
gmgn-cli market trending --chain sol --interval 5m --order-by volume --limit 50

# ソーシャルリンク付きのホットトークン、検証済み、honeypot ではない、24h の BSC
gmgn-cli market trending \
  --chain bsc --interval 24h \
  --filter has_social --filter not_honeypot --filter verified

トレンド。SOL by Launchpad プラットフォーム

--platform を使用して、トレンド結果を特定の launchpad のトークンのみにフィルタしてください。

# SOL 1m ホテスト。Pump.fun + letsbonk のみ（最もアクティブな launchpad）、ボリューム別にソート
gmgn-cli market trending \
  --chain sol --interval 1m \
  --platform Pump.fun --platform letsbonk \
  --order-by volume --limit 50 --raw

# SOL 5m ホテスト。Pump.fun + letsbonk + Moonshot、ボリューム別にソート
gmgn-cli market trending \
  --chain sol --interval 5m \
  --platform Pump.fun --platform letsbonk --platform moonshot_app \
  --order-by volume --limit 50 --raw

# SOL 1h トレンド。Pump.fun のみ、セーフティフィルタ付き
gmgn-cli market trending \
  --chain sol --interval 1h \
  --platform Pump.fun \
  --filter renounced --filter frozen --filter not_wash_trading \
  --order-by volume --limit 20 --raw

# SOL 1h トレンド。すべての主要 launchpad を組み合わせ
gmgn-cli market trending \
  --chain sol --interval 1h \
  --platform Pump.fun --platform letsbonk --platform moonshot_app \
  --platform pump_mayhem --platform pump_mayhem_agent --platform bonkers \
  --order-by volume --limit 50 --raw

トレンド。BSC by Launchpad プラットフォーム

# BSC 1m ホテスト。fourmeme（主な BSC launchpad）、ボリューム別にソート
gmgn-cli market trending \
  --chain bsc --interval 1m \
  --platform fourmeme --platform four_xmode_agent \
  --order-by volume --limit 50 --raw

# BSC 5m ホテスト。fourmeme ファミリー、ボリューム別にソート
gmgn-cli market trending \
  --chain bsc --interval 5m \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --order-by volume --limit 50 --raw

# BSC 1h トレンド。fourmeme とセーフティフィルタ
gmgn-cli market trending \
  --chain bsc --interval 1h \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

トレンド。ETH（プラットフォームフィルタなし）

# ETH 1h トレンド。すべてのトークン、ボリューム別にソート
gmgn-cli market trending --chain eth --interval 1h --order-by volume --limit 20

# ETH 1h トレンド。セーフティフィルタ付き
gmgn-cli market trending \
  --chain eth --interval 1h \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

# ETH 24h トレンド。スマートマネー数別にソート
gmgn-cli market trending \
  --chain eth --interval 24h \
  --filter not_honeypot --filter verified \
  --order-by smart_degen_count --limit 20 --raw

トレンド。Base by Launchpad プラットフォーム

# Base 1m ホテスト。clanker + zora（主な Base launchpad）、ボリューム別にソート
gmgn-cli market trending \
  --chain base --interval 1m \
  --platform clanker --platform zora --platform zora_creator \
  --order-by volume --limit 50 --raw

# Base 5m ホテスト。clanker + zora + virtuals_v2 + flaunch、ボリューム別にソート
gmgn-cli market trending \
  --chain base --interval 5m \
  --platform clanker --platform zora --platform zora_creator \
  --platform virtuals_v2 --platform flaunch \
  --order-by volume --limit 50 --raw

# Base 1h トレンド。すべての主要 launchpad とセーフティフィルタ
gmgn-cli market trending \
  --chain base --interval 1h \
  --platform clanker --platform zora --platform zora_creator \
  --platform virtuals_v2 --platform flaunch --platform baseapp \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

market trending レスポンスフィールド

レスポンスは data.rank です。ランク項目の配列です。各項目は 1 つのトークンを表します。

基本情報

フィールド	説明
address	トークンコントラクトアドレス
symbol / name	トークンティッカーとフルネーム
logo	トークンロゴの画像 URL
chain	チェーン識別子
total_supply	総トークン供給量
creator	クリエイターウォレットアドレス
launchpad_platform	ローンチ/プールプラットフォーム（例：Pump.fun、letsbonk、pool_meteora、fourmeme）
exchange	現在の DEX（例：meteora_damm_v2、raydium、pump_amm）
open_timestamp	オープンマーケットリスト時刻（Unix 秒）
creation_timestamp	トークン作成時刻（Unix 秒）
rank	このトレンドリスト内の位置（低い方がホット）
hot_level	トレンド強度レベル（高い方がホット）

価格とマーケット

フィールド	説明
price	USD での現在価格
market_cap	USD でのマーケットキャップ（直接利用可能。計算は不要）
liquidity	USD での現在流動性
volume	クエリされた間隔での USD での取引ボリューム
history_highest_market_cap	USD での全時間最高マーケットキャップ
initial_liquidity	トークンローンチ時の初期流動性
price_change_percent	クエリされた間隔での価格変化%
price_change_percent1m	過去 1 分での価格変化%
price_change_percent5m	過去 5 分での価格変化%
price_change_percent1h	過去 1 時間での価格変化%

取引活動

フィールド	説明
swaps	クエリされた間隔での総スワップ数
buys / sells	間隔でのバイ / セル数
holder_count	ユニークなトークンホルダー数
gas_fee	トランザクションあたりの平均ガス代

セキュリティとリスク

フィールド	チェーン	説明
renounced_mint	SOL	ミント権限放棄（1 = はい、0 = いいえ）
renounced_freeze_account	SOL	フリーズ権限放棄（1 = はい、0 = いいえ）
is_honeypot	BSC / Base	Honeypot フラグ（1 = はい、0 = いいえ）
is_open_source	すべて	コントラクト検証（1 = はい、0 = いいえ）
is_renounced	すべて	所有権放棄（1 = はい、0 = いいえ）
buy_tax / sell_tax	すべて	税率。空の文字列は 0（税金なし）を意味します
burn_status	すべて	流動性焼却ステータス（例："none"、"burn"）
top_10_holder_rate	すべて	トップ 10 ウォレット集中度（0–1）
rug_ratio	すべて	Rug pull リスクスコア（0–1）
is_wash_trading	すべて	Wash trading 検出（true / false）
rat_trader_amount_rate	すべて	インサイダー/スニークトレーディングボリュームの比率
bundler_rate	すべて	バンドルボットトレーディングボリュームの比率
entrapment_ratio	すべて	エントラップメントトレーディング比率
sniper_count	すべて	ローンチ時のスナイパーウォレット数
bot_degen_count / bot_degen_rate	すべて	ボット degen ウォレット数 / 比率
dev_team_hold_rate	すべて	Dev チーム保有比率
top70_sniper_hold_rate	すべて	トップ 70 スナイパー現在保有比率
lock_percent	すべて	流動性ロック率

Dev ステータス

フィールド	説明
creator_token_status	Dev 保有ステータス: creator_hold（保有中） / creator_close（売却/クローズ）
creator_close	creator_token_status == creator_close のブール値短縮形
dev_token_burn_ratio	Dev のトークンのうち焼却されたものの比率

スマートマネー

フィールド	説明
smart_degen_count	トークンを保有するスマートマネーウォレット数
renowned_count	トークンを保有する有名 / KOL ウォレット数
bluechip_owner_percentage	ブルーチップウォレットであるホルダーの比率（0–1）

ソーシャル

フィールド	説明
twitter_username	Twitter / X ユーザー名（完全な URL ではなく。リンクを取得するには https://x.com/ を前に付けてください）
website	プロジェクトウェブサイト URL
telegram	Telegram URL
cto_flag	コミュニティテイクオーバーフラグ（1 = CTO が発生）

Dexscreener マーケティング

フィールド	説明
dexscr_ad	Dexscreener 広告を配置（1 = はい）
dexscr_update_link	Dexscreener のソーシャルリンク更新（1 = はい）
dexscr_trending_bar	Dexscreener トレンドバー付け用に支払い（1 = はい）
dexscr_boost_fee	支払われた Dexscreener ブースト額（0 = なし）

---

ワークフロー: トレンド経由での取引機会の発見

取引機会を発見するための完全なワークフロー: docs/workflow-market-opportunities.md

ステップ: トレンドをフェッチ（50 結果、安全フィルタ）→ AI マルチファクター分析（スマートマネー、ボリューム、モメンタム、流動性、成熟度）→ トップ 5 テーブルを根拠付きで表示 → ディープダイブまたはスワップを提案。

結果に興味深いトークンが含まれている場合は、完全なトークンデューデリジェンスに進んでください: docs/workflow-token-research.md

新しい / launchpad トークンの場合 （market trenches）: セキュリティチェックとスマートマネーエントリ検出を含む構造化された初期プロジェクトスクリーニングワークフローを適用してください。docs/workflow-early-project-screening.md

日次市場概観の場合（ユーザーが「今日の市場はどうか」、「日次概要をください」、「スマートマネーが今日何を買っているか」と聞きます）: market trending + market trenches と gmgn-track smartmoney を組み合わせます。docs/workflow-daily-brief.md

トークン品質フィルタ基準

market trending または market trenches から返されたトークンを評価する場合、これらの基準を適用して、高品質な機会をノイズから素早く分離してください。フィルタリングなしで生結果を提示しないでください。

パス / ウォッチ / スキップ基準

シグナル	🟢 パス	🟡 ウォッチ	🔴 スキップ
smart_degen_count	≥ 3	1–2	0
rug_ratio	< 0.1	0.1–0.3	> 0.3
creator_token_status	creator_close	—	creator_hold
is_wash_trading	false	—	true → すぐにスキップ
top_10_holder_rate	< 0.20	0.20–0.50	> 0.50
liquidity	> $50k	$10k–$50k	< $10k
has_social（またはソーシャルフィールドが存在）	yes	—	no（弱いシグナルのみ）

クイック不適格ルール: rug_ratio > 0.3 またはまたは is_wash_trading = true またはまたは is_honeypot = 1 → すぐにスキップ、さらなる分析は不要です。

強い購入シグナルの組み合わせ: smart_degen_count ≥ 3 + rug_ratio < 0.2 + creator_close + is_wash_trading = false + liquidity > $50k → 高品質な機会、トークン研究全体に進みます。

ここで表示されたトークンの完全なデューデリジェンスについて: docs/workflow-token-research.md

トークンライフサイクルステージ

フィールド組み合わせを使用して、トークンが何のステージにあるかを決定してください。これはシグナルをどのように解釈するかに影響します。

ステージ 1。早期（新生）

インジケーター:

• creation_timestamp < 1 時間前
• hot_level 低いか上昇し始めたばかり
• smart_degen_count = 0、renowned_count = 0

解釈: スマートマネーシグナルには早すぎます。オンチェーンの実績がありません。高リスク、高リターン。ステージ 2 の確認を待ってから行動してください。 リスク許容度が最も高いトレーダーだけがここで参入します。

ステージ 2。ブレークアウト

インジケーター:

• smart_degen_count ≥ 3 そして上昇中
• ボリュームが急増（swaps_1h vs swaps_24h / 24 と比較。著しく高い）
• price_change_percent1h > 20%
• creator_token_status = creator_hold はこのステージで OK です（dev はまだ配布していません）

解釈: 最強のエントリシグナル。スマートマネーが蓄積しています。行動する前にセキュリティを検証してください。このウィンドウはしばしば短いです。予想ではなく確認時に行動してください。

ステージ 3。配布

インジケーター:

• creator_token_status = creator_close（dev は割り当てを売却しました）
• renowned_count 購入中（遅いソーシャルシグナル。KOL はしばしばスマートマネーの後に参入）
• smart_degen_count 横ばいまたは減少中
• ボリュームはまだ高いがモメンタムが遅下

解釈: 遅いステージエントリ。スマートマネーは小売/KOL 需要に出口を実行しているかもしれません。新しいエントリではより高いリスク。ステージ 2 から保有中であれば、出口レベルを評価してください。

ステージ 4。低下

インジケーター:

• すべてのウィンドウでボリュームが減少
• holder_count が減少
• rat_trader_amount_rate が高い（インサイダー/スニークトレーディングが支配的）
• smart_degen_count = 0 または明らかに減少中

解釈: 新しいエントリは完全に回避してください。まだ保有中であれば、出口を検討してください。機会はおそらく過ぎました。

market trenches パラメータ

インテント → --type マッピング（常に --type を明示的に指定してください）:

ユーザーインテント	--type 値
「新しいトークン」、「今上場したばかり」、「最近作成された」、「最新トークン」	new_creation
「卒業しようとしている」、「ほぼ完了」、「ボンディングカーブがほぼ満杯」	near_completion
「卒業したトークン」、「すでに DEX にある」、「オープンマーケットトークン」	completed
特定のステージが言及されていない	--type を省略（3 つすべてを返す）

パラメータ	必須	説明
--chain	はい	sol / bsc / base
--type	いいえ	クエリするカテゴリ、繰り返し可能: new_creation / near_completion / completed（デフォルト: すべて 3 つ）
--launchpad-platform	いいえ	Launchpad プラットフォームフィルタ、繰り返し可能（デフォルト: チェーンのすべてのプラットフォーム）
--limit	いいえ	カテゴリあたりの最大結果数、最大 80（デフォルト: 80）
--filter-preset	いいえ	名前付きサーバー側フィルタプリセット: safe / smart-money / strict
--sort-by	いいえ	クライアント側ソート（カテゴリあたり）: smart_degen_count / renowned_count / volume_24h / volume_1h / swaps_24h / swaps_1h / rug_ratio / holder_count / usd_market_cap / created_timestamp
--direction	いいえ	ソート方向: asc / desc（デフォルト: desc; rug_ratio の場合 asc）
--min-* / --max-*	いいえ	サーバー側フィルタ範囲フラグ。以下の「フィルタフィールドリファレンス」を参照してください

フィルタプリセット

プリセットはサーバー側に適用されます: API はトークンをフィルタしてから返します。

プリセット	適用されるサーバー側フィルタ
safe	max_rug_ratio=0.3 + max_bundler_rate=0.3 + max_insider_ratio=0.3
smart-money	min_smart_degen_count=1
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

プリセット + 明示的なフラグ相互作用: 明示的なフィルタフラグは常にプリセット値をオーバーライドします。例：--filter-preset safe --max-rug-ratio 0.1 は safe プリセットを適用しますが、rug_ratio 閾値を 0.1 にオーバーライドします。

すべてのフィルタフラグは API リクエストボディの一部として送信されます（サーバー側）。サーバーはトークンをフィルタしてから返します。--limit 80（デフォルトの最大値）を使用して、プールを最大化してください。

レスポンスフィールド: data.new_creation、data.pump、data.completed。各パラメータは RankItem の配列（market trending ランク項目と同じフィールド）です。重要: レスポンス内の data.pump はリクエスト内の --type near_completion に対応しています。API は常にこのカテゴリを near_completion ではなく pump キーの下に返します。

サーバー側フィルタフィールド

すべてのフィルタフラグは API リクエストボディの一部として送信されます。サーバーはトークンをフィルタしてから返します。フラグは --min-{field} / --max-{field} の命名規則に従います。

フラグペア	型	説明
--min-volume-24h / --max-volume-24h	float	24h 取引ボリューム（USD）
--min-net-buy-24h / --max-net-buy-24h	float	24h ネット購入ボリューム（USD）
--min-swaps-24h / --max-swaps-24h	int	24h 総スワップ数
--min-buys-24h / --max-buys-24h	int	24h バイ数
--min-sells-24h / --max-sells-24h	int	24h セル数
--min-visiting-count / --max-visiting-count	int	ビジター数
--min-progress / --max-progress	float	ボンディングカーブ進捗（0–1）
--min-marketcap / --max-marketcap	float	マーケットキャップ（USD）
--min-liquidity / --max-liquidity	float	流動性（USD）
--min-created / --max-created	duration	トークンの経過時間。単位サフィックス推奨: 秒（30s、10s）または分（0.5m、1m、5m、30m）。直値（例：5）は警告付きで分として扱われます。
--min-holder-count / --max-holder-count	int	ホルダー数
--min-top-holder-rate / --max-top-holder-rate	float	トップ 10 ホルダー集中比率（0–1）
--min-rug-ratio / --max-rug-ratio	float	Rug pull リスクスコア（0–1）
--min-bundler-rate / --max-bundler-rate	float	バンドル bot トレーディング比率（0–1）
--min-insider-ratio / --max-insider-ratio	float	インサイダートレーディング比率（0–1）
--min-entrapment-ratio / --max-entrapment-ratio	float	エントラップメント/フィッシングトレーディング比率（0–1）
--min-private-vault-hold-rate / --max-private-vault-hold-rate	float	プライベートボールト保有比率（0–1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	float	トップ 70 スナイパー保有比率（0–1）
--min-bot-count / --max-bot-count	int	ボットウォレット数
--min-bot-degen-rate / --max-bot-degen-rate	float	ボット degen ウォレット比率（0–1）
--min-fresh-wallet-rate / --max-fresh-wallet-rate	float	新規ウォレット比率（0–1）
--min-total-fee / --max-total-fee	float	総手数料
--min-smart-degen-count / --max-smart-degen-count	int	スマートマネーホルダー数
--min-renowned-count / --max-renowned-count	int	KOL / 有名ウォレット数
--min-creator-balance-rate / --max-creator-balance-rate	float	クリエイター保有比率（0–1）
--min-creator-created-count / --max-creator-created-count	int	クリエイターの総トークン作成数
--min-creator-created-open-count / --max-creator-created-open-count	int	クリエイターの卒業トークン数
--min-creator-created-open-ratio / --max-creator-created-open-ratio	float	クリエイターの卒業比率（0–1）
--min-x-follower / --max-x-follower	int	Twitter / X フォロワー数
--min-twitter-rename-count / --max-twitter-rename-count	int	Twitter リネーム数
--min-tg-call-count / --max-tg-call-count	int	Telegram 呼び出し数

Trenches フィルタ例

# セーフプリセットの適用（サーバー側）
gmgn-cli market trenches --chain sol --type new_creation --filter-preset safe

# 少なくとも 1 つのスマートマネーホルダーを要求（サーバー側）
gmgn-cli market trenches --chain sol --type new_creation --min-smart-degen-count 1

# セーフプリセット + スマートマネー要求 + スマート degen 数でソート（サーバー側フィルタ、クライアント側ソート）
gmgn-cli market trenches --chain sol --type new_creation \
  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count

# ストリクトプリセット。セーフ + スマートマネー + 最小ボリューム（サーバー側）
gmgn-cli market trenches --chain sol --type new_creation --type near_completion \
  --filter-preset strict --sort-by smart_degen_count

# 手動範囲フィルタ（すべてサーバー側で送信）
gmgn-cli market trenches --chain sol --type new_creation \
  --max-rug-ratio 0.3 --max-bundler-rate 0.3 --max-insider-ratio 0.3 \
  --min-smart-degen-count 1 --min-volume-24h 1000

# トークン年齢でフィルタ: 過去 30 分以内に作成されたトークンのみ
gmgn-cli market trenches --chain sol --type new_creation --max-created 30m

# マーケットキャップ範囲でフィルタ
gmgn-cli market trenches --chain sol --type new_creation \
  --min-marketcap 10000 --max-marketcap 500000

market trenches レスポンスフィールド

基本情報

フィールド	説明
address	トークンコントラクトアドレス
symbol / name	トークンシンボルと名前
launchpad_platform	ローンチプラットフォーム（例：Pump.fun、letsbonk）
exchange	現在の取引所（例：pump_amm、raydium）
usd_market_cap	USD でのマーケットキャップ
liquidity	USD での流動性
total_supply	総トークン供給量
created_timestamp	作成時刻（Unix 秒）
open_timestamp	オープンマーケットリスト時刻（Unix 秒、completed のみ）
complete_timestamp	ボンディングカーブ完了時刻（Unix 秒）
complete_cost_time	作成から完了までの時間（秒）

取引データ

フィールド	説明
swaps_1m / swaps_1h / swaps_24h	時間ウィンドウあたりのスワップ数
volume_1h / volume_24h	USD での取引ボリューム
buys_24h / sells_24h	24h でのバイ / セル数
net_buy_24h	24h のネット購入ボリューム
holder_count	トークンホルダー数

セキュリティとリスク

フィールド	チェーン	説明
renounced_mint	SOL	ミント権限が放棄されているかどうか（SOL 固有の概念; EVM チェーンでは常に false）
renounced_freeze_account	SOL	フリーズ権限が放棄されているかどうか（SOL 固有の概念; EVM チェーンでは常に false）
burn_status	すべて	流動性焼却ステータス
rug_ratio	すべて	Rug pull リスク比率
top_10_holder_rate	すべて	トップ 10 ホルダー集中比率
rat_trader_amount_rate	すべて	インサイダー / スニークトレーディングボリューム比率
bundler_trader_amount_rate	すべて	バンドルトレーディングボリューム比率
is_wash_trading	すべて	Wash trading が検出されるかどうか
sniper_count	すべて	スナイパーウォレット数
suspected_insider_hold_rate	すべて	疑われるインサイダー保有比率
open_source	すべて	コントラクトソースコードが検証されているかどうか（"yes" / "no" / "unknown"）
owner_renounced	すべて	コントラクト所有権が放棄されているかどうか（"yes" / "no" / "unknown"）
is_honeypot	BSC / Base	トークンが honeypot であるかどうか（"yes" / "no"）; SOL では空の文字列を返す（適用されません）
buy_tax	すべて	購入税の比率（例：0.03 = 3%）
dev_team_hold_rate	すべて	Dev チーム保有比率

Dev ホールディング

フィールド	説明
creator_token_status	Dev 保有ステータス（例：creator_hold、creator_close）
creator_balance_rate	総供給量に対する Dev 保有比率

スマートマネー

フィールド	説明
smart_degen_count	スマートマネーホルダー数
renowned_count	有名なウォレットホルダー数（KOL）

ソーシャルメディア

|