gmgn-market

コマンドを実行する前に必ず、gmgn-cli config --check を実行してください。終了コードが 0 の場合は、そのまま通常どおり続行します。終了コードが 1 の場合は、（1）gmgn-cli config を実行し、出力をユーザーに表示します。（2）ユーザーから API Key が送られてきたら、gmgn-cli config --apply <KEY> を実行して設定と検証を完了し、出力をユーザーに表示します。--check がエラー（不明なオプションまたはコマンドが見つからない）を返した場合は、更新するために npm install -g gmgn-cli を実行してから再試行するよう、ユーザーに伝えてください。

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

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

⚠️ IPv6 はサポートされていません：認証情報に問題がないように見えるのに 401 または 403 エラーが発生した場合は、ただちに IPv6 を確認してください。（1）すべてのネットワークインターフェースと IPv6 アドレスを一覧表示します。macOS では ifconfig | grep inet6、Linux では ip addr show | grep inet6 を実行してください。（2）https://ipv6.icanhazip.com にテストリクエストを送信します。応答が IPv6 アドレスの場合、送信トラフィックは IPv6 経由です。ユーザーにただちに「ネットワークインターフェースで IPv6 を無効にしてください。gmgn-cli コマンドは IPv4 経由でのみ動作します。」と伝えてください。

gmgn-cli ツールを使用して、トークンの K 線データを照会したり、トレンドのトークンを閲覧したり、Trenches のトークン一覧を表示したりできます。

コアコンセプト

• --filter チェーンのデフォルト設定 — SOL チェーンと EVM チェーンでは異なるデフォルトの安全フィルターがあり、--filter を省略すると自動的に適用されます。チェーン間で同じデフォルト設定が適用されると思い込まないでください。

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

• volume と amount（kline） — 命名は直感的ではありません。volume は取引の米ドル換算額、amount は取引されたトークン数です。価格が $0.0002 のトークンでは、両者に 5,000 倍の差があります。「取引された米ドルの額」には必ず volume を、「売買されたトークン数」には amount を使ってください。

• rug_ratio — ラグプルの可能性を推定する 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 固有の項目です。作成者がトークンの追加発行権限またはウォレット凍結権限を放棄したかどうかを示します。Solana では、両方が 1 であることが安全性の最低基準です。EVM チェーンでは常に false です（この概念は適用されません）。

• is_honeypot — EVM 固有（BSC / Base）の項目です。トークンコントラクトが売却を禁止しているかどうかを示します。SOL では常に空/null です。Solana では、値が空であることを「ハニーポットではない」と解釈しないでください。

• creator_token_status — 開発者の保有状況です。creator_hold は、開発者がまだトークンを保有している状態（売り圧力のリスク）です。creator_close は、開発者が割当分を売却またはバーンした状態（撤退シグナルが確認済み）です。

• cto_flag — コミュニティによる引き継ぎを示すフラグです。1 は、元の開発者がプロジェクトを放棄し、コミュニティグループがマーケティングや開発を引き継いだことを意味します。中立からポジティブなシグナルですが、状況に応じて評価してください。

• Trenches のカテゴリ — ローンチパッドトークンの 3 つのライフサイクル段階です。new_creation（作成直後で、まだボンディングカーブ上）、near_completion（ボンディングカーブがほぼ満了し、まもなく卒業）、completed（卒業し、オープンマーケット／DEX に移行済み）です。レスポンスでは、入力した --type にかかわらず、near_completion は常に 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	ローンチパッドプラットフォームで新たにローンチされたトークン — ユーザーが「新しいトークン」「ローンチされたばかりのトークン」「pump.fun／letsbonk の最新トークン」を尋ねた場合に使用します。 3つのカテゴリがあります：new_creation（作成されたばかり）、near_completion（ボンディングカーブがほぼ満了）、completed（公開市場／DEX に移行済み）
market signal	リアルタイムのトークンシグナルフィード — 価格急騰、スマートマネーの購入、大口購入、Dex 広告、CTO イベントなどを表示します。結果は trigger_at の降順で並べ替えられます。sol／bsc／robinhood／arc／stable のみ対応。グループあたり最大50件。
market hot-searches	ホット検索ランキング — visiting_count（検索数）に基づく、最も検索されているトークンのランキングです。ユーザーが「どのトークンが検索されているか」「最も検索されているトークン」「ホット検索リスト」「热搜榜」を尋ねた場合に使用します。 1回のリクエストで複数のチェーンに対応します。
market search	名前、シンボル、コントラクトアドレス、ウォレットアドレス、または ENS で特定のトークンまたはウォレットを検索します。一致したトークン（coins）とウォレット（wallets）の両方を返します。ユーザーがトークン／ウォレットを指定して見つけたい場合（「PEPE を検索」「このアドレスを調べて」「vitalik.eth を探して」「查一下这个代币/钱包」など）に使用します。ランキングの閲覧（trending／hot-searches）とは異なります。

対応チェーン

sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable（kline／trending／trenches／hot-searches 対応。signal は sol / bsc / robinhood / arc / stable に対応。search では --chain は省略可能です — 省略すると全チェーンを検索します。all と、tron / monad / megaeth / xlayer など、検索モジュールで有効化されているチェーン（動的に有効化されたチェーンを含む）を指定できます）

前提条件

• gmgn-cli がグローバルにインストールされていること — インストールされていない場合は、次を実行します：npm install -g gmgn-cli
• GMGN_API_KEY が ~/.config/gmgn/.env に設定されていること

レート制限への対応

このスキルで使用するすべての標準マーケットルートには、GMGN のプラン別リーキーバケットが適用されます。Free は 5/5、Plus は 20/20、Pro は 50/50（レート／容量）です。継続時のスループットはおよそ tier rate ÷ weight リクエスト／秒、最大バーストはおよそ floor(tier capacity ÷ weight) です。Pro 専用の 1s K ラインルートには、Pro API キーバケットと、それとは別の共有グローバルバケットが適用されます。

コマンド	ルート	重み
market kline（標準の解像度）	GET /v1/market/token_kline	2
market kline --resolution 1s（Pro 専用）	GET /v1/market/token_kline	Pro API キーバケットに対して 3。共有グローバル制限：500 req/s
market trending	GET /v1/market/rank	3
market trenches	POST /v1/trenches	2
market signal	POST /v1/market/token_signal	1
market hot-searches	POST /v1/market/hot_searches	3
market search	GET /v1/market/search	1

リクエストが 429 を返した場合：

• RATE_LIMIT_EXCEEDED の場合は、ユーザーに正確に次のように伝えてください：已达到当前套餐的限频上限，点击 https://gmgn.ai/ai?chain=bsc&tab=paid_plans 升级套餐，获得更高速率限制。このアップグレード案内は、ユーザーのタスクごとに最大 1 回だけ表示してください。同じクールダウン中に後続の RATE_LIMIT_BANNED 応答があっても、繰り返し案内しないでください。

• レスポンスヘッダーから 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 の場合、クールダウン中にリクエストを繰り返すと、1 回につき 5 秒ずつ禁止措置が延長され、最大 5 分に達することがあります。再試行を連続して送信しないでください。

• RATE_LIMIT_BANNED_MAX の場合、クールダウン中もリクエストが続いたため、禁止措置が 5 分の上限に達しています。このタスクでは、失敗したリクエストだけでなく、すべての GMGN 呼び出しを停止し、正確なリセット時刻をユーザーに伝えてください。reset_at より前にリクエストを送ると、禁止措置が再び 5 分にリセットされます。

• 403 PLAN_UPGRADE_REQUIRED の場合、このエンドポイントはユーザーのプランの容量を超えるレート制限の重みを必要とするため、そのプランでは成功しません。再試行や待機はせず、現在のプランではエンドポイントを利用できないことを伝え、レスポンスの upgrade_message を表示してください（アップグレードリンク https://gmgn.ai/ai?chain=bsc&tab=paid_plans が含まれています）。

market kline のパラメーター

パラメーター	必須	説明
--chain	はい	sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable
--address	はい	トークンのコントラクトアドレス
--resolution	はい	ローソク足の解像度：1s（Pro 専用。1 リクエストあたり最大 500 本） / 30s / 1m / 5m / 15m / 1h / 4h / 1d
--from	いいえ	開始時刻（Unix 秒）
--to	いいえ	終了時刻（Unix 秒）

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

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

フィールド	型	説明
time	number	ローソク足の開始時刻 — 秒単位の Unix タイムスタンプ
open	string	期間の開始時点における USD 建ての始値
close	string	期間の終了時点における USD 建ての終値
high	string	期間中の USD 建ての最高値
low	string	期間中の USD 建ての最安値
volume	string	ベーストークン単位の取引量（取引されたトークン数）
amount	string	USD建ての取引量（この期間のすべての取引のドル換算額）

重要な違い（名前からは直感的に分かりにくいため、推測しないでください）：

• volume = トークン数（例：5379110 は約 538 万トークンが取引されたことを意味します）
• amount = USD 建ての金額（例：1214 は約 1,214 ドルが取引されたことを意味します）—「USD でいくら取引されたか」を確認するにはこちらを使用します
• 1 ドルで取引されないトークンでは、volume と amount の値は桁違いになります（例：価格が 0.0002 ドルのトークンの場合、amount が 1,214 ドルなら 5,379,110 トークンに相当します）
• 指定した期間の USD 建て総取引量を求めるには、期間内のすべてのローソク足について amount を合計します
• 価格の推移を確認するには、close の値を時系列順（time の昇順）に読み取ります
• ボラティリティを検出するには、各ローソク足の high と low を比較します
• ローソク足は時系列順（古いものから）に返されます

market trending のオプション

--interval の選択ガイド — ユーザーが指定した時間枠に必ず合わせてください：

ユーザーの指定	--interval
「1m trending」／「今この瞬間に最も人気」	1m
「5m」／「5分」	5m
「1h」／「1時間」／時間の指定なし（デフォルト）	1h
「6h」／「6時間」	6h
「24h」／「今日」／「日次」	24h

オプション	説明
--chain	必須。sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable
--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 / four_xmode_agent / cubepeg / likwid / goplus_creator / goplus_skills / openfour / flap / flap_stocks / flap_aioracle / clanker / lunafun / pool_uniswap / pool_pancake。base：clanker / bankr / flaunch / zora / zora_creator / baseapp / basememe / virtuals_v2 / klik。eth：trench / clanker / klik / livo / stroid / pool_uniswap_v2 / pool_uniswap_v3 / printr

market trending のレンジフィルター

任意の --min-* / --max-* フラグは、サーバー側で数値レンジのフィルタリング（境界値を含む）を適用します。不明な指標はサービスによって無視されます。

オプション	説明
--min-volume / --max-volume	取引量（USD）
--min-liquidity / --max-liquidity	流動性（USD）
--min-marketcap / --max-marketcap	時価総額（USD）
--min-history-highest-marketcap / --max-history-highest-marketcap	過去最高時価総額（USD）
--min-swaps / --max-swaps	スワップ回数
--min-holder-count / --max-holder-count	保有者数
--min-gas-fee / --max-gas-fee	ガス代
--min-renowned-count / --max-renowned-count	KOL / 著名ウォレット数
--min-smart-degen-count / --max-smart-degen-count	スマートマネー保有者数
--min-bot-degen-count / --max-bot-degen-count	Bot degen ウォレット数
--min-visiting-count / --max-visiting-count	訪問者数
--min-price-change-percent / --max-price-change-percent	期間内の価格変動率
--min-insider-rate / --max-insider-rate	インサイダー取引率（0～1）。このフィールドを持たないトークンは除外されます
--min-bundler-rate / --max-bundler-rate	バンドル Bot 取引率（0～1）。このフィールドを持たないトークンは除外されます
--min-entrapment-ratio / --max-entrapment-ratio	エントラップメント取引率（0～1）。このフィールドを持たないトークンは除外されます
--min-top10-holder-rate / --max-top10-holder-rate	上位 10 位保有者の集中度（0～1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	上位 70 位スナイパーの保有率（0～1）
--min-dev-team-hold-rate / --max-dev-team-hold-rate	開発チームの保有率（0～1）。--min-dev-team-hold-rate は作成者に近いトークンも除外します
--min-created / --max-created	トークンの経過時間ウィンドウ。m（分）/h（時間）/d（日）のサフィックスを付けた期間文字列（例: 30m / 6h / 7d）。--min-created は最小経過時間（より新しいトークンを除外）、--max-created は最大経過時間（より古いトークンを除外）です。注意: 生の上流ランクインターフェースは分のみを受け付けますが、openapi-service はこのフィールドを転送しません — 経過時間ウィンドウを自身で評価します（カットオフ = 現在 − 期間、m/h/d に対してネイティブに計算）ので、ここでは 6h / 7d が機能します。必ず単位サフィックスを付けてください — 数値のみは受け付けられません。

使用例

Kline

1s は Pro API キーでのみ利用できます。1 秒のリクエストは最大 500 本のローソク足しか返さないため、要求するレンジは 500 秒以下にしてください。Free および Plus キーは 403 PRO_PLAN_REQUIRED を受け取ります。同じキーで再試行しないでください。インストール済みの CLI が 1s を拒否する場合は、再試行する前に更新してください。より粗い解像度に暗黙的にフォールバックしないでください。

# Last 500 seconds of 1-second candles (Pro only; macOS)
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1s \
  --from $(date -v-500S +%s) \
  --to $(date +%s)

# Last 1 hour of 1-minute candles
# macOS:
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1m \
  --from $(date -v-1H +%s) \
  --to $(date +%s)
# Linux: use $(date -d '1 hour ago' +%s) instead of $(date -v-1H +%s)

# Last 24 hours of 1-hour candles
# macOS:
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1h \
  --from $(date -v-24H +%s) \
  --to $(date +%s)
# Linux: use $(date -d '24 hours ago' +%s) instead of $(date -v-24H +%s)

# Raw output for further processing
gmgn-cli market kline --chain sol --address <addr> \
  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'

# ETH token kline — last 24h, 1h candles (macOS)
gmgn-cli market kline \
  --chain eth \
  --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  --resolution 1h \
  --from $(date -v-24H +%s) \
  --to $(date +%s)

Trending — 一般

# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
gmgn-cli market trending --chain sol --interval 1h --order-by volume --limit 20

# Top 50 tokens on SOL, 5m window, sorted by volume
gmgn-cli market trending --chain sol --interval 5m --order-by volume --limit 50

# Hot tokens with social links only, verified and not honeypot, on BSC over 24h
gmgn-cli market trending \
  --chain bsc --interval 24h \
  --filter has_social --filter not_honeypot --filter verified

Trending — ローンチパッドプラットフォーム別の SOL

--platform を使用して、トレンド結果を特定のローンチパッドのトークンのみに絞り込みます。

# SOL 1m hottest — Pump.fun + letsbonk only (most active launchpads), sorted by volume
gmgn-cli market trending \
  --chain sol --interval 1m \
  --platform Pump.fun --platform letsbonk \
  --order-by volume --limit 50 --raw

# SOL 5m hottest — Pump.fun + letsbonk + Moonshot, sorted by volume
gmgn-cli market trending \
  --chain sol --interval 5m \
  --platform Pump.fun --platform letsbonk --platform moonshot_app \
  --order-by volume --limit 50 --raw

# SOL 1h trending — Pump.fun only, with safety filters
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 trending — all major launchpads combined
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

Trending — ローンチパッドプラットフォーム別の BSC

# BSC 1m hottest — fourmeme (main BSC launchpad), sorted by volume
gmgn-cli market trending \
  --chain bsc --interval 1m \
  --platform fourmeme --platform four_xmode_agent \
  --order-by volume --limit 50 --raw

# BSC 5m hottest — all BSC launchpads, sorted by volume
gmgn-cli market trending \
  --chain bsc --interval 5m \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --order-by volume --limit 50 --raw

# BSC 1h trending — all BSC launchpads with safety filters
gmgn-cli market trending \
  --chain bsc --interval 1h \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

Trending — ローンチパッドプラットフォーム別の ETH

# ETH 1h trending — all platforms, sorted by volume
gmgn-cli market trending --chain eth --interval 1h --order-by volume --limit 20

# ETH 1h trending — specific platforms only
gmgn-cli market trending \
  --chain eth --interval 1h \
  --platform trench --platform clanker --platform klik \
  --order-by volume --limit 50 --raw

# ETH 1h trending — all ETH platforms with safety filters
gmgn-cli market trending \
  --chain eth --interval 1h \
  --platform trench --platform clanker --platform klik --platform livo --platform stroid \
  --platform pool_uniswap_v2 --platform pool_uniswap_v3 --platform printr \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

# ETH 24h trending — sorted by smart money count
gmgn-cli market trending \
  --chain eth --interval 24h \
  --filter not_honeypot --filter verified \
  --order-by smart_degen_count --limit 20 --raw

Trending — 数値レンジフィルター

# SOL 1h trending — liquidity 10k–1M, market cap above 50k, sorted by volume
gmgn-cli market trending \
  --chain sol --interval 1h \
  --min-liquidity 10000 --max-liquidity 1000000 --min-marketcap 50000 \
  --order-by volume --limit 30 --raw

# SOL 5m hottest — fresh tokens (under 30 min old) with smart money interest
gmgn-cli market trending \
  --chain sol --interval 5m \
  --max-created 30m --min-smart-degen-count 1 \
  --order-by volume --limit 50 --raw

# SOL 1h trending — exclude high-insider / high-bundler tokens
gmgn-cli market trending \
  --chain sol --interval 1h \
  --max-insider-rate 0.3 --max-bundler-rate 0.3 \
  --order-by volume --limit 20 --raw

Trending — ローンチパッドプラットフォーム別の Base

# Base 1m hottest — clanker + zora (main Base launchpads), sorted by volume
gmgn-cli market trending \
  --chain base --interval 1m \
  --platform clanker --platform zora --platform zora_creator \
  --order-by volume --limit 50 --raw

# Base 5m hottest — clanker + zora + virtuals_v2 + flaunch, sorted by volume
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 trending — all major launchpads with safety filters
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	ハニーポットのフラグ（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	すべて	ラグプルのリスクスコア（0–1）
is_wash_trading	すべて	ウォッシュトレードが検出されたか（true / false）
rat_trader_amount_rate	すべて	インサイダー／スニーク取引量の割合
bundler_rate	すべて	バンドルボットによる取引量の割合
entrapment_ratio	すべて	はめ込み取引の割合
sniper_count	すべて	ローンチ時のスナイパーウォレット数
bot_degen_count / bot_degen_rate	すべて	ボット系デゲンウォレットの数／割合
dev_team_hold_rate	すべて	開発チームの保有割合
top70_sniper_hold_rate	すべて	上位70スナイパーの現在の保有割合
lock_percent	すべて	流動性のロック率

開発者ステータス

フィールド	説明
creator_token_status	開発者の保有状況：creator_hold（引き続き保有）／creator_close（売却／クローズ済み）
creator_close	creator_token_status == creator_closeを示すブール値の略記
dev_token_burn_ratio	バーン済みの開発者保有トークンの割合

スマートマネー

フィールド	説明
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

新規／ローンチパッドのトークン（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（またはソーシャル関連フィールドが存在する場合）	あり	—	なし（シグナルとしては弱い）

即時失格ルール： 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 と swaps_24h / 24 を比較 — 前者が大幅に高い）
• price_change_percent1h > 20%
• この段階では creator_token_status = creator_hold でも問題ありません（開発者はまだトークンを配布していません）

解釈： 最も強い参入シグナルです。スマートマネーが買い集めています。行動する前にセキュリティを確認してください。この機会は短いことが多いため、先回りではなく、確認を得てから行動してください。

段階 3 — 分配

指標：

• creator_token_status = creator_close（開発者が割り当て分を売却済み）
• 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 / eth / arbitrum / hyperevm / robinhood / arc / stable
--type	いいえ	クエリするカテゴリー。複数回指定できます：new_creation / near_completion / completed（デフォルト：3 種類すべて）
--launchpad-platform	いいえ	ローンチパッドのプラットフォームフィルター。複数回指定できます。省略時：sol/bsc/base/eth/robinhood ではサーバーの固定デフォルト許可リストを使用し、arc/stable ではプラットフォームフィルターを適用しません。値を指定すると、そのデフォルトが置き換えられます。
--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-*	いいえ	サーバー側のフィルター範囲フラグ。以下のフィルターフィールドリファレンスを参照してください

チェーン別の --launchpad-platform の値（sol/bsc/base/eth/robinhood では、フラグを省略するとすべてのプラットフォームではなく、サーバーのデフォルト許可リストが使用されます）：

チェーン	プラットフォーム
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 / ray_launchpad / meteora_virtual_curve / xstocks
bsc	fourmeme / fourmeme_agent / bn_fourmeme / four_xmode_agent / cubepeg / likwid / goplus_creator / goplus_skills / openfour / flap / flap_stocks / flap_aioracle / clanker / lunafun
base	clanker / bankr / flaunch / zora / zora_creator / baseapp / basememe / virtuals_v2 / klik
eth	trench / clanker / klik / livo / stroid / pool_uniswap_v2 / pool_uniswap_v3 / printr
arc	dyorfun_v3 / dyorswap / trench / onmifun / sharcfun / klik
stable	dyorfun_v3 / dyorswap / trench

フィルタープリセット

プリセットはサーバー側で適用されます。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	24 時間の取引量（USD）
--min-net-buy-24h / --max-net-buy-24h	float	24 時間の純購入量（USD）
--min-swaps-24h / --max-swaps-24h	int	24 時間のスワップ総数
--min-buys-24h / --max-buys-24h	int	24 時間の購入数
--min-sells-24h / --max-sells-24h	int	24 時間の売却数
--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	ラグプルのリスクスコア（0–1）
--min-bundler-rate / --max-bundler-rate	float	バンドルボットの取引比率（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	ボット系デジェンウォレットの比率（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 のフィルター例

# Apply the safe preset (server-side)
gmgn-cli market trenches --chain sol --type new_creation --filter-preset safe

# Require at least 1 smart money holder (server-side)
gmgn-cli market trenches --chain sol --type new_creation --min-smart-degen-count 1

# Safe preset + require smart money + sort by smart degen count (server-side filter, client-side sort)
gmgn-cli market trenches --chain sol --type new_creation \
  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count

# Strict preset — safe + smart money + min $1k volume (server-side)
gmgn-cli market trenches --chain sol --type new_creation --type near_completion \
  --filter-preset strict --sort-by smart_degen_count

# Manual range filters (all sent server-side)
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

# Filter by token age: only tokens created within the last 30 minutes
gmgn-cli market trenches --chain sol --type new_creation --max-created 30m

# Filter by market cap range
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	米ドル建ての時価総額
liquidity	米ドル建ての流動性
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	米ドル建ての取引量
buys_24h / sells_24h	24 時間の買い／売りの回数
net_buy_24h	24 時間の純買い取引量
holder_count	トークン保有者数

セキュリティとリスク

フィールド	チェーン	説明
renounced_mint	SOL	ミント権限が放棄されているかどうか（SOL 固有の概念。EVM チェーンでは常に false）
renounced_freeze_account	SOL	凍結権限が放棄されているかどうか（SOL 固有の概念。EVM チェーンでは常に false）
burn_status	all	流動性のバーン状況
rug_ratio	all	ラグプルのリスク比率
top_10_holder_rate	all	上位 10 保有者の集中比率
rat_trader_amount_rate	all	インサイダー／先回り取引の取引量比率
bundler_trader_amount_rate	all	バンドル取引の取引量比率
is_wash_trading	all	ウォッシュトレードが検出されたかどうか
sniper_count	all	スナイパーウォレットの数
suspected_insider_hold_rate	all	インサイダーと疑われる保有者の保有比率
open_source	all	コントラクトのソースコードが検証済みかどうか（"yes" / "no" / "unknown"）
owner_renounced	all	コントラクトの所有権が放棄されているかどうか（"yes" / "no" / "unknown"）
is_honeypot	BSC / Base	トークンがハニーポットかどうか（"yes" / "no"）。SOL では空文字列を返します（該当なし）
buy_tax	all	買い税率（例：0.03 = 3%）
dev_team_hold_rate	all	開発チームの保有比率

開発者の保有状況

フィールド	説明
creator_token_status	開発者の保有状況（例：creator_hold、creator_close）
creator_balance_rate	総供給量に占める開発者の保有比率

スマートマネー

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

ソーシャルメディア

フィールド	説明
twitter	Twitter / X のリンク
telegram	Telegram のリンク
website	ウェブサイトのリンク
instagram	Instagram のリンク
tiktok	TikTok のリンク
has_at_least_one_social	ソーシャルメディアのリンクが少なくとも 1 つ存在するかどうか
x_user_follower	Twitter のフォロワー数
cto_flag	コミュニティテイクオーバー（CTO）が発生したかどうか

Dexscreener のマーケティング

フィールド	説明
dexscr_ad	Dexscreener に広告が掲載されているかどうか
dexscr_update_link	Dexscreener 上のソーシャルリンクが更新されているかどうか
dexscr_trending_bar	Dexscreener のトレンドバー掲載料が支払われているかどうか
dexscr_boost_fee	Dexscreener のブーストに支払われた金額（0 = なし）

trenches の結果を取得した後、トークンをユーザーに提示する前に「トークン品質フィルター基準」セクションを適用してください。 生の結果をそのまま出力せず、まずフィルタリングしてから有力な候補を提示してください。

Trenches フィルターの例

# Quick safe screen — exclude rugs, wash trading, and bundlers
gmgn-cli market trenches --chain sol --type new_creation \
  --filter-preset safe --raw

# Smart money screen — only tokens with smart money or KOL presence
gmgn-cli market trenches --chain sol \
  --type new_creation --type near_completion \
  --filter-preset smart-money \
  --sort-by smart_degen_count --raw

# Strict screen — safe + smart money + minimum volume, sorted by smart degens
gmgn-cli market trenches --chain sol --type completed \
  --filter-preset strict --sort-by smart_degen_count --raw

# Custom filter — no wash trading, rug_ratio <= 0.2, at least 1 smart degen
gmgn-cli market trenches --chain sol \
  --type new_creation --type near_completion \
  --exclude-wash-trading --max-rug-ratio 0.2 --min-smart-degen 1 \
  --sort-by smart_degen_count --raw

# BSC — safe screen on new tokens from fourmeme
gmgn-cli market trenches --chain bsc --type new_creation \
  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent \
  --filter-preset safe --sort-by volume_1h --raw

# Sort by rug_ratio ascending (safest first), no other filters
gmgn-cli market trenches --chain sol --type completed \
  --sort-by rug_ratio --raw

# Find tokens with many holders and strong 1h swap activity
gmgn-cli market trenches --chain sol --type completed \
  --min-holders 100 --min-swaps 50 \
  --sort-by swaps_1h --raw

Solana Trenches の例

# All three categories at once
gmgn-cli market trenches --chain sol --raw \
  --type new_creation --type near_completion --type completed \
  --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 \
  --limit 80

# New creation only
gmgn-cli market trenches --chain sol --raw \
  --type new_creation \
  --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 \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain sol --raw \
  --type near_completion \
  --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 \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain sol --raw \
  --type completed \
  --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 \
  --limit 80

BSC Trenches の例

# All three categories at once
gmgn-cli market trenches --chain bsc --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

# New creation only
gmgn-cli market trenches --chain bsc --raw \
  --type new_creation \
  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain bsc --raw \
  --type near_completion \
  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain bsc --raw \
  --type completed \
  --launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent \
  --launchpad-platform cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

Base Trenches の例

# All three categories at once
gmgn-cli market trenches --chain base --raw \
  --type new_creation --type near_completion --type completed \
  --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 \
  --limit 80

# New creation only
gmgn-cli market trenches --chain base --raw \
  --type new_creation \
  --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 \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain base --raw \
  --type near_completion \
  --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 \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain base --raw \
  --type completed \
  --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 \
  --limit 80

ETH Trenches の例

# All three categories at once
gmgn-cli market trenches --chain eth --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

# New creation only
gmgn-cli market trenches --chain eth --raw \
  --type new_creation \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain eth --raw \
  --type completed \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

Arc Trenches の例

# All three categories at once
gmgn-cli market trenches --chain arc --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# New creation only
gmgn-cli market trenches --chain arc --raw \
  --type new_creation \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain arc --raw \
  --type near_completion \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain arc --raw \
  --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

Stable Trenches の例

# All three categories at once
gmgn-cli market trenches --chain stable --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# New creation only
gmgn-cli market trenches --chain stable --raw \
  --type new_creation \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain stable --raw \
  --type near_completion \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain stable --raw \
  --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

出力形式

market kline — 価格の概要

ローソク足を取得した後、簡潔な価格分析を提示します。ローソク足の配列をそのまま出力しないでください。

{symbol} — {resolution} chart ({from} → {to})
Open: ${open of first candle}  |  Close: ${close of last candle}  |  Range: ${min low} – ${max high}
Total volume: ${sum of all volume fields} USD
Trend: [brief description — e.g. "steady uptrend", "sharp drop then recovery", "sideways"]

market trending — トップトークンのテーブル

上位の結果（デフォルトは上位10件。指定があればその件数）をテーブルで提示します。

# | Symbol | Price | MCap | Volume ({interval}) | 1h Chg | SM | Liq | Platform | Signal

ここで、シグナルはトークンのデータから判定される品質フラグです。

• 🟢 合格：smart_degen_count ≥ 3 かつ rug_ratio < 0.2 かつ is_wash_trading = false
• 🔴 スキップ：rug_ratio > 0.3 または is_wash_trading = true または is_honeypot = 1
• 🟡 要注目：それ以外すべて

続いて、特に注目すべきトークンがあれば、1行で紹介します（例：「TOKEN1 はスマートマネーの保有者が12人おり、1時間で+85％です — 🟢 強いシグナル」）。

market trenches — カテゴリー別のグループ表示

各カテゴリーを見出し付きで個別に提示します。

🆕 New Creation ({count} tokens)
# | Symbol | Created | Liquidity | Swaps (1h) | Smart Degens | Social

⏳ Near Completion ({count} tokens)
# | Symbol | Market Cap | Swaps (1h) | Smart Degens | Social

✅ Graduated ({count} tokens)
# | Symbol | Market Cap | Volume (1h) | Smart Degens | Social

market signal のパラメーター

チェーン：sol ／ bsc ／ robinhood ／ arc ／ stable のみ。グループごとの結果は最大50件です。1つのリクエストで異なるシグナルタイプを対象にするには、--groups を使って複数のグループを指定します。

単一グループ（個別フラグ）：

signal_type ／ --signal-type ／ --groups の JSON では、シグナルタイプ 14、15、16 を渡さないでください。いずれかのグループにこれらが含まれると、OpenAPI は 400 を返します。--signal-type を省略すると、サポートされているすべてのタイプ（1〜13、17〜21）が検索されます。

オプション	必須	説明
--chain	はい	sol ／ bsc ／ robinhood ／ arc ／ stable
--signal-type	いいえ	シグナルタイプ。複数回指定できます：1〜13、17〜21。デフォルト：サポートされているすべてのタイプ。「シグナルタイプ」を参照してください。
--mc-min	いいえ	トリガー時の最低時価総額（USD）
--mc-max	いいえ	トリガー時の最高時価総額（USD）
--trigger-mc-min	いいえ	シグナルのトリガー時点での最低時価総額（USD）
--trigger-mc-max	いいえ	シグナルのトリガー時点での最高時価総額（USD）
--total-fee-min	いいえ	支払われた最低合計手数料（USD）
--total-fee-max	いいえ	支払われた最高合計手数料（USD）
--min-create-or-open-ts	いいえ	トークンの作成または開始時刻の下限（Unix 秒の文字列）
--max-create-or-open-ts	いいえ	トークンの作成または開始時刻の上限（Unix 秒の文字列）

複数グループによる上書き：

--groups '<json_array>' を渡すと、1つのリクエストで複数のフィルターグループを検索できます。アップストリームはすべてのグループを並列実行し、trigger_at の降順で結果を統合します。--groups が指定されている場合、上記の個別フラグはすべて無視されます。

gmgn-cli market signal --chain sol \
  --groups '[{"signal_type":[12,13]},{"signal_type":[6,7],"mc_min":50000}]'

シグナルタイプ

値	名前	説明
1	SignalType1	一般的なシグナル（K 線の価格急騰）
2	SignalTypeDexAd	Dex 広告の掲載
3	SignalTypeDexUpdateLink	Dex のソーシャルリンク更新
4	SignalTypeDexTrendingBar	Dex のトレンドバー
5	SignalTypeDexBoost	Dex Boost
6	SignalTypePriceUp	価格急騰
7	SignalTypePriceATH	史上最高値
8	SignalTypeMcpKeyLevel	時価総額の重要水準
9	SignalTypeLive	ライブ配信
10	SignalTypeBundlerSell	バンドラーによる売却
11	SignalTypeCto	コミュニティによる引き継ぎ（CTO）
12	SignalTypeSmartDegenBuy	スマートマネーによる購入
13	SignalTypePlatformCall	プラットフォームコール
14	SignalTypeLargeAmountBuy	大口購入
15	SignalTypeMultiBuy	複数回の購入
16	SignalTypeMultiLargeBuy	複数回の大口購入
17	SignalTypeBagsClaims	Bags クレーム
18	SignalTypePumpClaims	Pump クレーム
19	SignalTypePlatformCallV2	プラットフォームコール（V2）
20	SignalTypeKOLBuy	KOL による購入
21	SignalTypeBankerClaims	Banker クレーム（Base チェーンの Banker プラットフォームにおけるクレーム手数料）

market signal のレスポンスフィールド

レスポンス配列の各項目は、1件のシグナルイベントです。

フィールド	型	説明
id	string	シグナルイベント ID
token_address	string	トークンのコントラクトアドレス
signal_type	number	シグナルの種類（1–21。上記のシグナルの種類を参照）
trigger_at	number	シグナルがトリガーされた時刻の Unix タイムスタンプ（秒）
trigger_mc	number	シグナルのトリガー時点の時価総額（USD）
first_trigger_mc	number	このトークンで最初にトリガーされた時点の時価総額（USD）
market_cap	number	現在の時価総額（USD）
ath	number	史上最高時価総額（USD）
signal_times	number	このトークンでこのシグナルがトリガーされた合計回数
signal_times_by_type	object	種類別のシグナルトリガー回数
cur_data	object	クエリ時点のリアルタイムのトークン統計（下記を参照）
data	object	トリガー時点の上流データの完全なスナップショット（チェーン固有、未加工のまま引き渡し）

cur_data フィールド：

フィールド	型	説明
top_10_holder_rate	number	上位10保有者の集中率（0–1）
holder_count	number	現在の保有者数
liquidity	number	現在の流動性（USD）

使用例

# All supported signal types on SOL (no --signal-type)
gmgn-cli market signal --chain sol --raw

# Smart money buys only (type 12)
gmgn-cli market signal --chain sol --signal-type 12 --raw

# Price spikes + ATH (types 6 and 7) with market cap filter
gmgn-cli market signal --chain sol \
  --signal-type 6 --signal-type 7 \
  --mc-min 50000 --mc-max 5000000 --raw

# Smart money buys on BSC
gmgn-cli market signal --chain bsc --signal-type 12 --raw

# Multi-group: parallel groups (do not use signal_type 14–16 — API returns 400)
gmgn-cli market signal --chain sol \
  --groups '[{"signal_type":[12]},{"signal_type":[6,7]}]' --raw

# Multi-group: combine signal type filter with market cap range per group
gmgn-cli market signal --chain sol \
  --groups '[{"signal_type":[12,13],"mc_min":100000},{"signal_type":[6,7],"mc_min":50000,"mc_max":1000000}]' --raw

market hot-searches のパラメーター

ホット検索ランキングを返します。現在、最も多く検索されているトークンを、visiting_count（検索の注目度）順に並べたランキングです。チェーン横断の上位500件ランキングで、1回のリクエストで複数のチェーンを対象にできます。「最も検索されているトークン」「ホット検索リスト」「热搜榜」「みんなが何を見ているか」を調べる場合に使用してください。market trending（スワップアクティビティ順）とは異なり、「最も多く取引されているもの」を返すものではありません。

オプション	説明
--chain <chain...>	繰り返し指定できます。sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable。省略すると、デフォルトの9チェーンセットをクエリします（各チェーンに対し、24h とチェーンに応じた安全フィルターを適用）。
--interval <interval>	1m / 5m / 1h / 6h / 24h（デフォルトは 24h）。指定したすべての --chain に適用されます。
--limit <n>	チェーンごとの最大結果数（デフォルトは 500）。
--filter <tag...>	繰り返し指定できるブール型フィルタータグ（下流の filter.filters 配列）。⚠️ SOL のデフォルト：renounced frozen、EVM のデフォルト：not_honeypot verified renounced。 --filter を省略しても「フィルターなし」にはなりません。サーバーがチェーンごとのデフォルトを適用します。正確な語彙については、下記のフィルタータグ表を参照してください。
--min-* / --max-* <n>	数値範囲の境界。market trending と同じ指標名を使用します（例：--min-liquidity、--max-marketcap、--min-smart-degen-count）。サーバー側で --interval に応じて変換されます。--min-created / --max-created はトークンの経過時間を指定します。下記の範囲フィルター表を参照してください。
--params <json>	完全な上書き：パラメーターオブジェクトの JSON 配列です。指定した場合、--chain / --interval / --limit / --filter とすべての範囲フラグは無視されます。フィルターフィールドは各パラメーターにフラット化して追加されます（ネストされた filter オブジェクトはありません）：{ "label": "...", "chain": "...", "interval": "...", "filters": [...], "limit": 500, "min_liquidity": 1000 } — パラメーターでは filters、limit、min_created/max_created、およびランキング形式の min_<metric>/max_<metric> キーを指定できます。

market hot-searches のフィルタータグ（--filter / filter.filters）

後段の（gmgn rank filter-service）では、各タグを AND 条件として評価します。トークンがリストに残るには、すべてのタグを通過する必要があります。不明なタグは無視され、何も行いません（そのまま通過するため）、認識されないタグではフィルタリングされません。スペルが重要です。このタグセットは filter-service の語彙であり、market trending のタグ名とは少し異なります（下記の別名に関する注記を参照）。

認識されるタグは次のものだけです（それ以外は何も行いません）。

タグ	チェーン	通過条件
renounced	sol / EVM	sol：mint authority が放棄済み（renounced_mint == 1）；EVM：owner が放棄済み（is_renounced == 1；寛容な判定で、nil は通過）
frozen	sol のみ	freeze authority が放棄済み（renounced_freeze_account == 1）；sol 以外は常に失敗
is_burnt	すべて	LP プールがバーン済み（burn_status == "burn"）
token_burnt	すべて	作成者がトークンをバーン済み（dev_token_burn_ratio > 0）
not_wash_trading	すべて	ウォッシュトレーディングとしてフラグ付けされていない
not_honeypot	EVM	ハニーポットではない（is_honeypot == 0；寛容な判定で、nil は通過）
verified	EVM	コントラクトがオープンソース（is_open_source == 1；寛容な判定で、nil は通過）
locked	EVM	流動性の 50% 以上がロック済み（lock_percent >= 0.5）
has_social	すべて	Twitter、Telegram、または Website がある
distribed	すべて	上位 10 保有者の保有率が (0, 0.3]（適切に分散されている）
not_risk	すべて	複合的な低リスクフィルター（sol：流動性≥4000 + mint 放棄済み + 上位 10 保有率<0.3 + freeze 放棄済み + LP バーン済み；EVM：ハニーポットではない + 流動性≥4000 + オープンソース + 放棄済み + ロック率≥0.5）
img_not_duplicate	すべて	アバター画像が重複していない（image_dup == "0"）
social_not_duplicate	すべて	ソーシャルリンクが共有されていない（twitter_dup == 0 && telegram_dup == 0 && website_dup == 0）
creator_hold	すべて	開発者がまだ保有している（creator_close ではない）
creator_close	すべて	開発者が売却／クローズ済み（creator_token_status == "creator_close"）
dexscr_update_link	すべて	DexScreener でソーシャルリンクが更新済み（> 0）
launching	すべて	まだローンチパッドのボンディングカーブ上にある（launchpad_status == "0"）；両方を許可するには migrated と組み合わせます
migrated	すべて	DEX へ卒業／移行済み（launchpad_status == "1"）；両方を許可するには launching と組み合わせます
hide_b20	base のみ	トークン標準が b20 ではない（base 以外では何もしません）
hide_non_b20	base のみ	トークン標準が b20（base 以外では何もしません）

⚠️ market trending とは名前が異なります。 このパスでは launching / migrated（is_internal_market / is_out_market ではありません）と img_not_duplicate / social_not_duplicate（not_image_dup / not_social_dup ではありません）を使用します。market trending ではサポートされますが、このエンドポイントでは認識されないタグ（ここでは何も行わず無視されます）：dexscr_ad、dexscr_trending_bar、dexscr_boost、cto_flag、is_internal_market、is_out_market、not_image_dup、not_social_dup。

market hot-searches の範囲フィルター（--min-* / --max-*）

数値範囲には market trending と同じランク形式のメトリクス名を使用します。各パラメータにフラット化して送信され、サーバー側でそのパラメータの --interval に対応する下流のフィールドに変換されます。閉区間です。下流が読み取れないメトリクスは破棄されます（通信上でサイレントな no-op になるのではなく、リクエスト前に削除されます）。

フラグのペア	型	メトリクス
--min-volume / --max-volume	float	取引量（USD） — --interval のウィンドウにバインドされます
--min-swaps / --max-swaps	int	スワップ回数 — --interval のウィンドウにバインドされます
--min-price-change-percent / --max-price-change-percent	float	価格変動率 — 1m / 5m / 1h のみ。6h / 24h では破棄されます
--min-liquidity / --max-liquidity	float	流動性（USD）
--min-marketcap / --max-marketcap	float	時価総額（USD）
--min-history-highest-marketcap / --max-history-highest-marketcap	float	過去最高時価総額（USD）
--min-holder-count / --max-holder-count	int	ホルダー数
--min-gas-fee / --max-gas-fee	float	ガス代
--min-renowned-count / --max-renowned-count	int	KOL / 著名ホルダー数
--min-smart-degen-count / --max-smart-degen-count	int	スマートマネーホルダー数
--min-bot-degen-count / --max-bot-degen-count	int	Bot-degen ウォレット数
--min-visiting-count / --max-visiting-count	int	訪問者数
--min-insider-rate / --max-insider-rate	float	インサイダー取引比率（0〜1）。このフィールドを持たないトークンは除外されます
--min-bundler-rate / --max-bundler-rate	float	バンドルボット取引比率（0〜1）。このフィールドを持たないトークンは除外されます
--min-entrapment-ratio / --max-entrapment-ratio	float	エントラップメント取引比率（0〜1）。このフィールドを持たないトークンは除外されます
--min-top10-holder-rate / --max-top10-holder-rate	float	上位10ホルダーの集中度（0〜1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	float	上位70スナイパーの保有比率（0〜1）
--min-dev-team-hold-rate / --max-dev-team-hold-rate	float	開発チームの保有比率（0〜1）
--min-created / --max-created	duration	トークンの経過時間ウィンドウ（30m / 6h / 7d）。min_created = 最小経過時間、max_created = 最大経過時間

動作に関する注意:

• --chain all は 有効ではありません。チェーンをまたいで集計するには、--chain を複数回指定します（または --chain を省略してデフォルトの9チェーンセットを使用します）。
• --chain を指定して --filter を省略した場合、サーバーがチェーンに適したデフォルトフィルターを適用します。そのため、明示的な --filter がなくても各チェーンはフィルタリングされます。
• チェーンによって返される件数は異なります。あるチェーンのトークン数は、そのチェーンのトークンのうち何件がグローバル top-500 に入ったかによって決まります（通常は sol が最も多くなります）。

market hot-searches のレスポンスフィールド

レスポンスの data は配列です。各要素は、1 つの (interval, chain) の結果ブロックです。

フィールド	型	説明
interval	string	このブロックの間隔
chain	string	このブロックのチェーン
version	string	サブスクリプションのバージョン — WebSocket の再接続時に使用するため、保存してください
tokens	array	ランク順のトークン（検索の注目度の降順）、最大 500 件。各トークンには 1 始まりの rank が含まれます

トークンのフィールドは market trending と同じロング形式のフィールドです — サーバーが上流の短縮コードをマッピングするため、v_c / mc / s ではなく、visiting_count / market_cap / symbol を直接参照します。主なフィールド：

フィールド	説明
address	トークンのコントラクトアドレス
chain	チェーン
name / symbol	トークン名 / ティッカー
price	現在価格（USD）
visiting_count	主なランキングキー — 検索 / 訪問の注目度
market_cap	時価総額（USD）
volume	この間隔の取引量（USD）
liquidity	流動性（USD）
swaps / buys / sells	スワップ / 買い / 売りの件数
holder_count	保有者数
rank	ブロック内の 1 始まりの順位

すべてのフィールドについては、上記の market trending のレスポンスフィールド セクションを参照してください。hot-searches のトークンは、同一の RankItem 構造を使用します。

market hot-searches の使用例

# Default 9-chain hot-search ranking (sol/bsc/base/eth/arbitrum/hyperevm/robinhood/arc/stable, each 24h)
gmgn-cli market hot-searches --raw

# SOL only, 24h hot-search list
gmgn-cli market hot-searches --chain sol --interval 24h --raw

# SOL + BSC + Base, 1h window, top 50 per chain
gmgn-cli market hot-searches --chain sol --chain bsc --chain base --interval 1h --limit 50 --raw

# SOL with custom boolean filters
gmgn-cli market hot-searches --chain sol --interval 24h \
  --filter renounced --filter frozen --raw

# SOL 1h hot-searches with numeric range filters (same metric names as `market trending`)
gmgn-cli market hot-searches --chain sol --interval 1h \
  --min-liquidity 10000 --min-volume 5000 --min-smart-degen-count 1 --raw

# Range filter by token age + market cap
gmgn-cli market hot-searches --chain sol --interval 24h \
  --max-created 7d --min-marketcap 50000 --raw

# Full per-param override via JSON (different filters per chain, incl. ranges)
gmgn-cli market hot-searches --raw --params '[
  {"label":"hot-search","chain":"sol","interval":"24h","filters":["renounced","frozen"],"limit":500,"min_liquidity":10000},
  {"label":"hot-search","chain":"bsc","interval":"24h","filters":["not_honeypot","verified","renounced"],"limit":500}
]'

market hot-searches — 出力形式

チェーンごとに表示し、visiting_count（検索の注目度）の順に並べます。

🔥 Hot Searches — {chain} ({interval})
# | Symbol | Price | MCap | Volume | Search Heat (visiting_count) | Liq

---

market search のパラメーター

ユーザーが指定した特定のトークンまたはウォレットを、トークン名、シンボル、コントラクトアドレス、ウォレットアドレス、または ENS で検索します。1 回のリクエストで、一致するトークン（coins）とウォレット（wallets）の両方が返されます。ユーザーが具体的な検索対象を提示した場合に使用します。ランキングを見たい場合は、代わりに market trending / market hot-searches を使用してください。

パラメーター	必須	説明
--query / -q	はい	検索キーワード — トークン名、シンボル、コントラクトアドレス、ウォレットアドレス、または ENS。不可視文字や制御文字を除去した後、1～100 Unicode 文字である必要があります。
--chain	いいえ	結果を 1 つのチェーンに限定します。すべてのチェーンを検索する場合は省略してください。all および有効な任意のチェーンを指定できます（「サポート対象チェーン」を参照 — 9 つのコアチェーンに加え、tron / monad / megaeth / xlayer / hyperevm などの動的に有効化されたチェーンが含まれます）。
--launchpad-platform	いいえ	ローンチパッドプラットフォームの完全一致フィルター。複数回指定可能で、最大 50 個の値を指定できます（例：pump / moonshot / raydium / pinksale）。coins のみをフィルターし、wallets には影響しません。
--is-og	いいえ	true = OG トークンのみ、false = 非 OG トークンのみ。OG フィルターを適用しない場合は省略してください。coins のみが対象です。
--is-launched	いいえ	true = すでにローンチ済み（オープンマーケット）のトークンのみ。false または省略時はローンチフィルターを適用しません。coins のみが対象です。
--order-by	いいえ	weight のみ指定できます — coins を加重関連度スコアの降順で並べ替え、ハニーポットトークンを除外します。coins のみが対象です。

動作に関する注意事項：

• --launchpad-platform、--is-og、--is-launched、--order-by は coins リストにのみ適用されます。wallets リストはこれらのフラグの影響を受けません。
• wallets の結果は最大 50 件です。
• レスポンススキーマは、下流の search_v3 API からの生の追加型パススルーです。返却前に、すべての文字列フィールドのメタデータがサニタイズされます。予告なく新しいフィールドが追加される場合があるため、フィールドの種類が固定されていると想定しないでください。不明なフィールドは推測せず、調べてください。

market search のレスポンスフィールド

data には、2 つの配列が含まれます。coins（一致したトークン）と wallets（一致したウォレット）です。

coins[] — 一致したトークン

フィールド	説明
chain	チェーン識別子
address	トークンコントラクトアドレス
name / symbol	トークン名／ティッカー
price	現在の価格（USD、文字列）
mcp	時価総額（USD、文字列）— キーは短い mcp であり、market_cap ではありません
holder_count	トークン保有者の数

追加のトークンフィールドが含まれる場合があります（search_v3 から追加でそのまま渡されます）。

wallets[] — 一致したウォレット

フィールド	説明
chain	チェーン識別子
address	ウォレットアドレス
twitter_username	紐付けられた Twitter／X のハンドル（空の場合があります）
wallet_tags	GMGN ウォレットタグの配列（例：スマートマネー／KOL）。空の場合があります

market search の使用例

# Search "pepe" on ETH — best matches first (weighted, honeypots dropped)
gmgn-cli market search --query pepe --chain eth --order-by weight

# Search across all chains by symbol
gmgn-cli market search --query trump

# Look up a specific token contract address (SOL)
gmgn-cli market search --query <token_address> --chain sol

# Look up a wallet by address or ENS
gmgn-cli market search --query vitalik.eth
gmgn-cli market search --query 0x220866b1a2219f40e72f5c628b65d54268ca3a9d

# SOL pump.fun launched tokens matching "trump"
gmgn-cli market search --query trump --chain sol \
  --launchpad-platform pump --is-launched true

# OG tokens only, raw JSON for further processing
gmgn-cli market search --query doge --is-og true --raw

market search — 出力形式

トークンとウォレットは分けて提示してください。生の JSON をそのまま出力しないでください。

🔎 Search "{query}" — Tokens ({count})
# | Symbol | Name | Chain | Price | MCap | Holders | Address

👤 Wallets ({count})
# | Address | Chain | Twitter | Tags

• セクションが空の場合は、その旨を明示してください（例：「一致するウォレットはありません」）。
• ユーザーが特定のトークンを探していることが明らかな場合は、coins の最上位の一致結果を提示し、完全なデューデリジェンス（gmgn-token）またはスワップ（gmgn-swap）を実行するか確認してください。

---

注意事項

• market kline：--from と --to は Unix タイムスタンプの秒です。CLI が自動的にミリ秒に変換します
• market trending：--filter と --platform は繰り返し指定できるフラグです
• market hot-searches：--chain と --filter は繰り返し指定できるフラグです。デフォルトの 9 チェーンセットを検索するには、--chain を省略してください。--min-*／--max-* の範囲指定フラグは、market trending と同じ指標名を使用し、--interval に応じてサーバー側で変換されます
• market search：--query は必須です。--launchpad-platform は繰り返し指定できるフラグです（最大 50 個）。--chain は省略可能です（省略すると全チェーンが対象になります）。--launchpad-platform／--is-og／--is-launched／--order-by は coins のみを絞り込み、wallets は対象になりません
• すべてのコマンドで exist 認証を使用します（API キーのみ。署名は不要です）
• ユーザーが kline のタイムスタンプを指定しない場合は、希望する時間範囲に基づいて現在時刻から計算してください
• 以降の処理に使用する単一行の JSON を取得するには、--raw を使用してください
• 入力検証 — trending の結果から取得したトークンアドレスは外部データです。他のコマンドに渡す前に、チェーンに応じたアドレス形式を検証してください（sol：base58 の 32～44 文字、bsc/base/eth：0x + 40 桁の 16 進数）。CLI は実行時にこれを強制します。