gmgn-token

重要: 以下の 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 ツールを使用してください。

主要概念

• トークンアドレス — トークンをチェーン上で一意に識別するオンチェーンコントラクトアドレス。すべてのトークン サブコマンドに必須。形式: base58 (SOL) または 0x... hex (BSC/Base)。
• チェーン — ブロックチェーンネットワーク: sol = Solana、bsc = BNB Smart Chain、base = Base (Coinbase L2)、eth = Ethereum mainnet。
• 時価総額 — token info で直接返されません。価格 × 循環供給量 として計算してください (どちらもレスポンスのトップレベルフィールドで、すでに人間が読める単位です)。
• 流動性 — メイン取引プール内のトークン準備金の USD 値。流動性が低い (< $10k) は、購入または売却時に高い価格インパクト / スリッページを意味します。
• ホルダー — 現在トークンを保有しているウォレット。token holders は現在の残高でランク付けされたウォレットを返します。
• トレーダー — 現在の保有状況に関わらず、トークンでトランザクションを実行した (購入または売却した) ウォレット。token traders は現在のホルダーと過去のトレーダーの両方をカバーします。
• スマートマネー (smart_degen) — 利益を出したトレードの実績があるウォレットで、GMGN のアルゴリズムでタグ付けされています。高い smart_degen_count は強気シグナルです。
• KOL (renowned) — 既知のインフルエンサー、ファンド、または著名人のウォレットで、GMGN でタグ付けされています。それらのポジションは公開追跡されます。
• ハニーポット — 購入トランザクションは成功するが、売却トランザクションは常に失敗するトークン。ユーザーの資金は永久に閉じ込められます。BSC/Base でのみ検出可能 (is_honeypot)。SOL には適用されません。
• 放棄済み (ミント / フリーズ / 所有権) — デベロッパーがその権限を永久に放棄しました。SOL の場合: renounced_mint (新しい供給を作成できない) と renounced_freeze_account (ウォレットをフリーズできない) が両方 true は安全なベースラインです。EVM の場合: owner_renounced "yes" はバックドアがないことを意味します。
• rug_ratio — ラグプルの可能性を推定する 0–1 のリスクスコア。0.3 より上の値は高リスク。二項的な安全/危険フラグとして扱わないでください — 他のシグナルと組み合わせて使用してください。
• ボンディングカーブ — ローンチパッド (例: Pump.fun、letsbonk) で使用される価格発見メカニズム。より多くが購入されるとトークン価格が上がります。曲線が満杯になると、トークンはオープン DEX プールに「卒業」します。is_on_curve: true はトークンがまだ卒業していないことを意味します。
• ウォレットタグ — GMGN が割り当てたウォレットのラベル: smart_degen (スマートマネー)、renowned (KOL)、sniper (トークン公開時にスナイプ)、bundler (ボット束買い)、rat_trader (インサイダー/スニークトレード)。--tag を使用して token holders / token traders をこれらのラベルでフィルタリングしてください。

サブコマンド

サブコマンド	説明
token info	基本情報 + リアルタイム価格、流動性、時価総額、総供給量、ホルダー数、ソーシャルリンク (時価総額 = 価格 × 循環供給量)
token security	セキュリティメトリクス (ハニーポット、税金、ホルダー集中度、コントラクトリスク)
token pool	流動性プール情報 (DEX、準備金、流動性深度)
token holders	トップトークンホルダーリスト (損益内訳付き)
token traders	トップトークントレーダーリスト (損益内訳付き)

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

sol / bsc / base / eth

前提条件

• gmgn-cli がグローバルにインストール済み — 不足している場合は、npm install -g gmgn-cli を実行してください
• GMGN_API_KEY が ~/.config/gmgn/.env で設定されている

レート制限の処理

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

コマンド	ルート	ウェイト
token info	GET /v1/token/info	1
token security	GET /v1/token/security	1
token pool	GET /v1/token/pool_info	1
token holders	GET /v1/market/token_top_holders	5
token traders	GET /v1/market/token_top_traders	5

リクエストが 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
   

パラメータ — token info / token security / token pool

パラメータ	必須	説明
--chain	はい	sol / bsc / base / eth
--address	はい	トークンコントラクトアドレス
--raw	いいえ	生の単一行 JSON を出力 (パイプまたはさらに処理する場合)

パラメータ — token holders / token traders

パラメータ	必須	デフォルト	説明
--chain	はい	—	sol / bsc / base / eth
--address	はい	—	トークンコントラクトアドレス
--limit	いいえ	20	結果の数、最大 100
--order-by	いいえ	amount_percentage	ソートフィールド — 以下の表を参照
--direction	いいえ	desc	ソート方向: asc / desc
--tag	いいえ	—	ウォレットフィルタ: smart_degen / renowned / fresh_wallet / dev / sniper / rat_trader / bundler / transfer_in / dex_bot / bluechip_owner。すべてのウォレットを返すには省略してください。
--raw	いいえ	—	生の単一行 JSON を出力

--order-by 値

値	説明
amount_percentage	保有総供給量のパーセンテージでソート (デフォルト)
profit	実現利益 (USD) でソート
unrealized_profit	未実現利益 (USD) でソート
buy_volume_cur	買い音量でソート
sell_volume_cur	売却音量でソート

--tag 値

値	説明
smart_degen	スマートマネーウォレット (歴史的にハイパフォーマンストレーダー)
renowned	KOL / 有名なウォレット (インフルエンサー、ファンド、著名人)
fresh_wallet	事前のトレード履歴がない新しいウォレット
dev	トークンデベロッパー / クリエーターウォレット
sniper	ローンチ時にトークンをスナイプしたウォレット
rat_trader	インサイダー / スニークトレード中のウォレット
bundler	ボット束買いウォレット
transfer_in	このトークンのトランスファーイン記録があるウォレット
dex_bot	DEX ボットウォレット (Axiom、Photon、BullX、Trojan、GMGN、Drops、PepeBoost、Padre)
bluechip_owner	確立された bluechip トークンを保有しているウォレット

--tag + --order-by 組み合わせガイド

--tag と --order-by は独立しており、すべての --order-by 値は --tag の有無にかかわらず有効です。--tag を省略するとすべてのウォレットが返されます (フィルタなし)。

一般的なユースケースの推奨される組み合わせ:

目標	--tag	--order-by
供給量別の最大スマートマネーホルダー	smart_degen	amount_percentage
実現利益が最も高いスマートマネー	smart_degen	profit
未実現ゲインに座っているスマートマネー	smart_degen	unrealized_profit
積極的に蓄積しているスマートマネー	smart_degen	buy_volume_cur
配布中のスマートマネー (出口シグナル)	smart_degen	sell_volume_cur
すでに利益を得た KOL	renowned	profit
ペーパーゲインで保持している KOL	renowned	unrealized_profit
最大ホルダー全体 (フィルタなし)	(省略)	amount_percentage

レスポンスフィールドリファレンス

token info — 主要フィールド

レスポンスには 5 つのネストされたオブジェクトがあります: pool、dev、link、stat、wallet_tags_stat。解析時にドット記法でフィールドにアクセスしてください (例: link.website、stat.top_10_holder_rate、dev.creator_address)。

トップレベルフィールド

フィールド	説明
address	トークンコントラクトアドレス
symbol / name	トークンティッカーと完全な名前
decimals	トークン小数点以下の桁数
total_supply	総トークン供給量 (ほとんどのトークンについて circulating_supply と同じ)
circulating_supply	循環供給量
max_supply	最大供給量
price	現在の USD 単価
liquidity	合計流動性 (USD) (最大プールから)
holder_count	ユニークトークンホルダーの数
logo	トークンロゴ画像 URL
creation_timestamp	トークン作成時刻 (Unix 秒)
open_timestamp	トークンが取引用にオープンした時刻 (Unix 秒)
biggest_pool_address	メイン流動性プールのアドレス
og	トークンが OG トークンとしてフラグ付けされているかどうか (true / false)
launchpad	ローンチパッド識別子 (例: pump、moonshot)
launchpad_status	ローンチパッド状態: 0 = オープンなし、1 = ライブ、2 = 移行済み
launchpad_progress	ローンチパッドボンディングカーブの進捗 (0–1)
launchpad_platform	ローンチパッドプラットフォーム名
migrated_pool	移行後のプールアドレス
migration_market_cap	移行時の時価総額 (USD、float)
migration_market_cap_quote	migration_market_cap の引用通貨
ath_price	過去最高価格 (USD、float)
locked_ratio	ロック済み供給量の比率 (0–1、float)

pool オブジェクト — メイン流動性プール詳細

フィールド	説明
pool.pool_address	プールコントラクトアドレス
pool.quote_address	クォートトークンアドレス (例: USDC、SOL、WETH)
pool.quote_symbol	クォートトークンシンボル (例: USDC、SOL)
pool.exchange	DEX 名 (例: meteora_dlmm、raydium、pump_amm、uniswap_v3)
pool.liquidity	プール流動性 (USD)
pool.base_reserve	ベーストークン準備金額
pool.quote_reserve	クォートトークン準備金額
pool.base_reserve_value	ベース準備金 USD 価値
pool.quote_reserve_value	クォート準備金 USD 価値
pool.fee_ratio	プール取引手数料比率 (例: 0.1 = 0.1%)
pool.creation_timestamp	プール作成時刻 (Unix 秒)

dev オブジェクト — トークンクリエーター / デベロッパー情報

フィールド	説明
dev.creator_address	クリエーターウォレットアドレス
dev.creator_token_balance	クリエーターの現在のトークン残高
dev.creator_token_status	クリエーター保有状況: hold (まだ保有) / sell (売却/出口)
dev.top_10_holder_rate	トップ 10 ウォレットが保有する供給量の比率 (0–1)
dev.twitter_name_change_history	過去の Twitter ユーザー名変更の配列 (各エントリに twitter_username、rename_timestamp があります)
dev.dexscr_ad	クリエーターが DEXScreener 広告を購入: 1 = はい、0 = いいえ
dev.dexscr_update_link	クリエーターが DEXScreener ソーシャル/リンクを更新: 1 = はい、0 = いいえ
dev.dexscr_boost_fee	クリエーターが DEXScreener Boost を使用: 1 = はい、0 = いいえ
dev.dexscr_trending_bar	トークンが DEXScreener トレンディングバーに表示: 1 = はい、0 = いいえ
dev.dexscr_ad_ts	DEXScreener 広告購入のタイムスタンプ (Unix 秒)
dev.dexscr_update_link_ts	DEXScreener リンク更新のタイムスタンプ (Unix 秒)
dev.dexscr_boost_ts	DEXScreener Boost のタイムスタンプ (Unix 秒)
dev.dexscr_trending_bar_ts	DEXScreener トレンディングバー表示のタイムスタンプ (Unix 秒)
dev.cto_flag	トークンが Community Takeover を受けた (オリジナルデベロッパーが放棄): 1 = はい、0 = いいえ
dev.fund_from	クリエーターウォレットに資金を提供したアドレス
dev.fund_from_ts	その資金イベントのタイムスタンプ (Unix 秒)
dev.creator_open_count	このクリエーターが以前ローンチしたトークン数
dev.twitter_del_post_token_count	クリエーターが Twitter から削除した投稿数
dev.twitter_create_token_count	クリエーターが Twitter でプロモーションしたトークン数
dev.offchain	トークンがオフチェーントークンであるかどうか
dev.ath_token_info	クリエーターの過去最高トークン情報オブジェクト (オプション); 以下のサブフィールドを参照
dev.ath_token_info.ath_token	クリエーターの過去最高パフォーマンストークンのコントラクトアドレス
dev.ath_token_info.ath_mc	そのトークンの過去最高市場資本 (USD、文字列)
dev.ath_token_info.avatar	トークンロゴ URL
dev.ath_token_info.symbol	トークンシンボル
dev.ath_token_info.name	トークン名
dev.ath_token_info.creation_timestamp	トークン作成時刻 (Unix 秒)

link オブジェクト — ソーシャルおよびエクスプローラーリンク

フィールド	説明
link.twitter_username	Twitter / X ユーザー名 (完全な URL ではなく)
link.website	プロジェクトウェブサイト URL
link.telegram	Telegram URL
link.discord	Discord URL
link.instagram	Instagram URL
link.tiktok	TikTok URL
link.youtube	YouTube URL
link.description	トークン説明テキスト
link.gmgn	GMGN トークンページ URL
link.geckoterminal	GeckoTerminal ページ URL
link.verify_status	ソーシャル認証状況 (整数)

stat オブジェクト — オンチェーン統計

フィールド	説明
stat.holder_count	ホルダー数 (トップレベル holder_count と同じ)
stat.top_10_holder_rate	トップ 10 ウォレットが保有する供給量の比率 (0–1)
stat.dev_team_hold_rate	デベロッパーチームウォレットが保有する比率
stat.creator_hold_rate	クリエーターウォレットが保有する比率
stat.creator_token_balance	生のクリエータートークン残高
stat.top_rat_trader_percentage	ラット/インサイダートレーダーからの音量比率
stat.top_bundler_trader_percentage	バンドラーボットからの音量比率
stat.top_entrapment_trader_percentage	エントラップメントトレーダーからの音量比率
stat.bot_degen_count	ボット degen ウォレット数
stat.bot_degen_rate	ボット degen ウォレットの比率
stat.fresh_wallet_rate	ホルダー間の新規/フレッシュウォレットの比率
stat.private_vault_hold_rate	プライベートボルト (消滅) アドレスが保有する比率 — GMGN UI で「vanish」として表示されます (0–1)

wallet_tags_stat オブジェクト — ウォレット種類の内訳

フィールド	説明
wallet_tags_stat.smart_wallets	トークンを保有しているスマートマネーウォレット数
wallet_tags_stat.renowned_wallets	トークンを保有している著名な / KOL ウォレット数
wallet_tags_stat.sniper_wallets	スナイパーウォレット数
wallet_tags_stat.rat_trader_wallets	ラットトレーダーウォレット数
wallet_tags_stat.bundler_wallets	バンドラーボットウォレット数
wallet_tags_stat.whale_wallets	クジラウォレット数
wallet_tags_stat.fresh_wallets	フレッシュウォレット数
wallet_tags_stat.top_wallets	トップランク付けウォレット数

---

token security — 主要フィールド

コントラクト安全性

フィールド	チェーン	説明
is_honeypot	BSC / Base	トークンがハニーポットであるかどうか ("yes" / "no"); SOL では空の文字列
open_source	すべて	コントラクトソースコード認証済み: "yes" / "no" / "unknown"
owner_renounced	すべて	コントラクト所有権が放棄済み: "yes" / "no" / "unknown"
renounced_mint	SOL	ミント権限が放棄済み (SOL 固有; EVM では常に false)
renounced_freeze_account	SOL	フリーズ権限が放棄済み (SOL 固有; EVM では常に false)
buy_tax / sell_tax	すべて	税率 — 例: 0.03 = 3%; 0 = 税なし

ホルダー集中度とリスク

フィールド	説明
top_10_holder_rate	トップ 10 ウォレットが保有する供給量の比率 (0–1); より高い = より集中
dev_team_hold_rate	デベロッパーチームウォレットが保有する比率
creator_balance_rate	トークンクリエーターウォレットが保有する比率
creator_token_status	デベロッパー保有状況: creator_hold (まだ保有) / creator_close (売却/クローズ)
suspected_insider_hold_rate	疑わしいインサイダーウォレットが保有する比率

トレーディングリスク

フィールド	説明
rug_ratio	ラグプルリスクスコア (0–1); より高い = より危険
is_wash_trading	ウォッシュトレード活動が検出されたかどうか (true / false)
rat_trader_amount_rate	スニーク/インサイダートレードからの音量比率
bundler_trader_amount_rate	バンドルトレード (ボット駆動) からの音量比率
sniper_count	ローンチ時にスナイプしたスナイパーウォレット数
burn_status	流動性プールのバーン状態 (例: "burn" = バーン済み、"" = バーンなし)

---

token pool — 主要フィールド

フィールド	説明
address	プールコントラクトアドレス
base_address	ベーストークンアドレス (クエリされたトークン)
quote_address	クォートトークンアドレス (例: SOL、USDC、WETH)
exchange	DEX 名 (例: raydium、pump_amm、uniswap_v3、pancakeswap)
liquidity	プール流動性 (USD)
base_reserve	ベーストークン準備金額
quote_reserve	クォートトークン準備金額
price	プール準備金から導出された現在の USD 単価
creation_timestamp	プール作成時刻 (Unix 秒)

---

token holders / token traders — レスポンスフィールド

レスポンスは list 配列を持つオブジェクトです。list 内の各項目は 1 つのウォレットを表します。

ID と保有

フィールド	説明
address	ウォレットアドレス
account_address	トークンアカウントアドレス (トークンを保有しているオンチェーンアカウント、ウォレットアドレスとは異なります)
addr_type	アドレスタイプ: 0 = 通常のウォレット、2 = 取引所 / 流動性プール
exchange	addr_type が 2 の場合の取引所またはプール名 (例: pump_amm、raydium)
wallet_tag_v2	このリストのランクラベル (例: TOP1、TOP2、...)
native_balance	ネイティブトークン残高 (最小単位、SOL の場合ラムポート)
balance	現在のトークン残高 (人間が読める単位)
amount_cur	balance と同じ — 現在保有するトークン量
usd_value	現在の価格での現在の保有量の USD 値
amount_percentage	保有総供給量の比率 (0–1); 例: 0.05 = 5%
is_on_curve	true = ボンディングカーブ上 (pump.fun 卒業前); false = オープン市場
is_new	新しく作成されたウォレットであるかどうか
is_suspicious	このウォレットが疑わしいとフラグ付けされているかどうか
transfer_in	現在の保有が転送 (購入ではない) で受け取られたかどうか

トレーディング概要

フィールド	説明
buy_volume_cur	合計買い音量 (USD)
sell_volume_cur	合計売却音量 (USD)
buy_amount_cur	合計買いトークン
sell_amount_cur	合計売却トークン
sell_amount_percentage	購入したトークンの売却済み比率 (0–1); 1.0 = 完全に出口
buy_tx_count_cur	買いトランザクション数
sell_tx_count_cur	売却トランザクション数
netflow_usd	正味 USD フロー = 売却収入 − 買いコスト (負 = 正味支出)
netflow_amount	正味トークンフロー = 購入 − 売却 (正 = まだ正味ポジションを保有)

コストと P&L

フィールド	説明
avg_cost	トークンあたりの平均買値 (USD)
avg_sold	トークンあたりの平均売値 (USD)
history_bought_cost	購入に費やした合計 USD
history_bought_fee	購入で支払った合計手数料 (USD)
history_sold_income	売却から受け取った合計 USD
history_sold_fee	売却で支払った合計手数料 (USD)
total_cost	手数料を含む合計原価
profit	合計利益 (USD) (実現 + 未実現)
profit_change	合計利益率 = 利益 / total_cost
realized_profit	完了した売却から実現した利益 (USD)
realized_pnl	実現利益率 = realized_profit / buy_cost
unrealized_profit	現在の価格での現在の保有に対する未実現利益 (USD)
unrealized_pnl	未実現利益率; 現在の保有がない場合は null

転送履歴

フィールド	説明
current_transfer_in_amount	現在の期間に転送で受け取ったトークン (購入ではない)
current_transfer_out_amount	現在の期間に転送で送信されたトークン (売却ではない)
history_transfer_in_amount	転送で受け取った歴史的合計トークン
history_transfer_in_cost	転送受け取ったトークンの推定原価
history_transfer_out_amount	転送で送信された歴史的合計トークン
history_transfer_out_income	転送送信されたトークンの推定収入
history_transfer_out_fee	転送送信で支払われた手数料
transfer_in_count	インバウンド転送数
transfer_out_count	アウトバウンド転送数

タイミング

フィールド	説明
start_holding_at	ウォレットがこのトークンを初めて取得した Unix タイムスタンプ
end_holding_at	ウォレットが完全に出口した Unix タイムスタンプ; まだ保有している場合は null
last_active_timestamp	このトークンの最後のオンチェーンアクティビティの Unix タイムスタンプ
last_block	最後のアクティビティのブロック番号

ウォレット ID

フィールド	説明
name	ウォレット表示名 (既知の場合)
twitter_username	Twitter / X ユーザー名
twitter_name	Twitter / X 表示名
avatar	アバター画像 URL
tags	プラットフォームレベルのウォレットタグ (例: ["kol"]、["smart_degen"]、["axiom"])
maker_token_tags	このウォレットのトークン固有の動作タグ (例: ["bundler"]、["paper_hands"]、["top_holder"])
created_at	ウォレット作成タイムスタンプ (Unix 秒); 不明な場合は 0

共有資金

フィールド	説明
native_transfer	このウォレットへの最初のネイティブトークン (SOL/BNB/ETH) 転送 — オリジナルの資金源を示します; 同じ native_transfer.address を共有するウォレットは共通のオリジンから資金を提供されている可能性があります (コーディネートされたウォレット / 同じオペレーター)

最後のトランザクションレコード

以下の各フィールドは name、address、timestamp、tx_hash、type を持つオブジェクトです:

フィールド	説明
token_transfer	最近のトークン転送 (買いまたは売り)
token_transfer_in	最近のインバウンドトークン転送
token_transfer_out	最近のアウトバウンドトークン転送

---

使用例

token info — 基本情報と価格を取得

# SOL トークンの現在の価格と時価総額を取得
gmgn-cli token info --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# BSC トークンの基本情報を取得
gmgn-cli token info --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8

# Base トークンの基本情報を取得
gmgn-cli token info --chain base --address 0x4200000000000000000000000000000000000006

# ETH トークンの基本情報を取得
gmgn-cli token info --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

# ダウンストリーム処理用の生 JSON 出力
gmgn-cli token info --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --raw

token security — 購入前の安全性確認

# SOL トークンがミント権限とフリーズ権限を放棄したかどうかを確認
gmgn-cli token security --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# BSC トークンがハニーポットであるか、コントラクトが認証済みかを確認
gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8

# Base トークンの税金、ラグ比率、インサイダー集中度をチェック
gmgn-cli token security --chain base --address 0x4200000000000000000000000000000000000006

# ETH トークンのハニーポットとコントラクトリスクをチェック
gmgn-cli token security --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

# キーフィールド解析用の生出力 (例: is_honeypot、buy_tax、rug_ratio)
gmgn-cli token security --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 --raw

token pool — 流動性深度をチェック

# SOL トークンのプール情報を取得 (流動性、準備金、DEX)
gmgn-cli token pool --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# BSC トークンのプール情報を取得
gmgn-cli token pool --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8

# ETH トークンのプール情報を取得
gmgn-cli token pool --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

token holders — ホルダー分布を分析

# 供給量パーセンテージ別トップ 20 ホルダー (デフォルト)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# パーセンテージでソートされたトップ 50 ホルダー
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --limit 50 --order-by amount_percentage --direction desc

# トップ 50 スマートマネーホルダー (最高信念ウォレット)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --limit 50 --tag smart_degen --order-by amount_percentage

# 実現利益でランク付けされたトップ KOL ウォレット (すでに利益を得た人)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag renowned --order-by profit --direction desc --limit 20

# 最も大きなゲインに座っているスマートマネー (最大利益を保有)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag smart_degen --order-by unrealized_profit --direction desc --limit 20

# 最も最近購入しているホルダー (買いモメンタムシグナル)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag smart_degen --order-by buy_volume_cur --direction desc --limit 20

# 最も売却しているホルダー (出口シグナル / 配布警告)
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag renowned --order-by sell_volume_cur --direction desc --limit 20

# BSC トークンホルダー — 利益別の KOL ウォレット
gmgn-cli token holders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
  --tag renowned --order-by profit --direction desc --limit 50

# ETH トークンホルダー — 供給量パーセンテージ別のスマートマネー
gmgn-cli token holders --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  --tag smart_degen --order-by amount_percentage --direction desc --limit 20

# ダウンストリーム分析用の生出力
gmgn-cli token holders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --limit 100 --raw

token traders — --tag + --order-by 組み合わせガイド

一般的な token traders ユースケースのために右の組み合わせを選択するために、このテーブルを使用してください:

ユースケース	--tag	--order-by
最高買い音量を持つスマートマネー	smart_degen	buy_volume_cur
最高売却音量を持つスマートマネー (出口シグナル)	smart_degen	sell_volume_cur
最近活動した KOL	renowned	last_active_timestamp
最も利益のあるスマートマネートレーダー	smart_degen	profit
まだ保有しているスナイパー	sniper	amount_percentage
最も大きな未実現ゲインに座っているスマートマネー	smart_degen	unrealized_profit
すでに利益を得た KOL	renowned	profit

token traders — アクティブなトレーダーを検索

# 保有供給量別のトップ 20 アクティブトレーダー (デフォルト)
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# 実現利益でランク付けされたスマートマネートレーダー
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag smart_degen --order-by profit --direction desc --limit 50

# 未実現利益でランク付けされた KOL トレーダー (ペーパーゲインでまだ保有)
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag renowned --order-by unrealized_profit --direction desc --limit 20

# 最高買い音量を持つスマートマネートレーダー (積極的な蓄積)
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag smart_degen --order-by buy_volume_cur --direction desc --limit 20

# 売却音量でランク付けされたスマートマネートレーダー (配布)
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag smart_degen --order-by sell_volume_cur --direction desc --limit 20

# 最も悪いパフォーマンスの KOL トレーダー (最も損失 — コントラリアンシグナル)
gmgn-cli token traders --chain sol --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --tag renowned --order-by profit --direction asc --limit 20

# BSC トークントレーダーの利益でソート
gmgn-cli token traders --chain bsc --address 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 \
  --tag smart_degen --order-by profit --direction desc --limit 50

# ETH トークントレーダーの利益でソート
gmgn-cli token traders --chain eth --address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  --tag smart_degen --order-by profit --direction desc --limit 50

---

トークンクイックスコアリングカード

token security と token info を取得した後、このスコアリングカードを適用して構造化された判定を提供してください。ユーザーが安全性チェックまたはデューディリジェンスをリクエストしたときはこのステップをスキップしないでください。

フィールド	✅ 安全	⚠️ 警告	🚫 危険 (ハードストップ)
is_honeypot	"no"	—	"yes" → すぐに停止
open_source	"yes"	"unknown"	"no"
owner_renounced	"yes"	"unknown"	"no"
renounced_mint (SOL)	true	—	false
renounced_freeze_account (SOL)	true	—	false
rug_ratio	< 0.10	0.10–0.30	> 0.30
top_10_holder_rate	< 0.20	0.20–0.50	> 0.50
creator_token_status	creator_close	—	creator_hold
buy_tax / sell_tax	0	0.01–0.05	> 0.10
sniper_count	< 5	5–20	> 20
smart_wallets (wallet_tags_stat から)	≥ 3	1–2	0 (弱気、ハードストップではない)
renowned_wallets (wallet_tags_stat から)	≥ 1	—	0 (ニュートラル、ハードストップではない)

最終スコアリングロジック:

• is_honeypot = "yes" の場合 → ハードストップを直ちに実行、他のシグナルに関わらず進まないでください
• 他の 🚫 フィールドが存在する場合 → スキップ (強い警告 — ユーザーに提示)
• smart_wallets = 0 だけはハードストップではありません — これはまだスマートマネーの関心がないことを意味し、非常に新しいトークンにとっては弱気ですが失格ではありません
• 3 つ以上の ⚠️ で 🚫 がない場合 → さらに研究が必要 — 結果を提示して、ユーザーに進め方を尋ねてください
• ほとんど ✅ で smart_wallets ≥ 3 の場合 → 研究の価値あり — ホルダー/トレーダー分析に進んでください

ワークフロー: 完全なトークンデューディリジェンス

ユーザーが完全なトークン研究 / デューディリジェンスをリクエストする場合は、docs/workflow-token-research.md のステップに従ってください。

ステップ: token info → token security → token pool → 市場ヒートチェック → token holders/traders (スマートマネーシグナル) → 決定フレームワーク。

より包括的なレポート用 (ユーザーが「ディープレポート」、「完全な分析」、「これは大きなポジションの価値があるか」をリクエスト) は、拡張ワークフローを使用してください: docs/workflow-project-deep-report.md。これは、スコア付きマルチディメンション分析 (ファンダメンタルズ + セキュリティ + 流動性 + スマートマネーコンビクション + 価格アクション) を追加し、完全に書かれたレポートを生成します。

保有ポジションのアクティブなリスク監視 (ユーザーが「リスク警告あるか」、「クジラがダンプしているか」、「流動性はまだ健全か」をリクエスト) の場合、以下に従ってください: docs/workflow-risk-warning.md。token security + token pool + token holders を使用してクジラの出口、流動性ドレイン、開発者ダンプをフラグ付けしています。

---

出力フォーマット

token info — サマリーカード

簡潔なカードとして提示してください。生の JSON をダンプしないでください。

{symbol} ({name})
価格: ${price}  |  時価総額: ~${price × circulating_supply}  |  流動性: ${liquidity}
ホルダー: {holder_count}  |  スマートマネー: {wallet_tags_stat.smart_wallets}  |  KOL: {wallet_tags_stat.renowned_wallets}
ソーシャル: @{link.twitter_username}  |  {link.website}  |  {link.telegram}

ソーシャルフィールドが空の場合は、null を表示するのではなく、省略してください。

token security — リスク評価サマリー

セキュリティデータを取得した後、このフォーマットを使用して構造化されたリスクサマリーを提示してください:

トークン: {symbol}  |  チェーン: {chain}  |  アドレス: {短いアドレス}
─── セキュリティ ──────────────────────────────────────
コントラクト認証済み:    ✅ はい  / 🚫 いいえ / ⚠️ 不明
所有権放棄済み:      ✅ はい  / 🚫 いいえ / ⚠️ 不明
ハニーポット:             ✅ いいえ   / 🚫 はい — 購入しないでください
ミント放棄済み (SOL): ✅ はい  / ⚠️ いいえ
フリーズ放棄済み(SOL):✅ はい  / ⚠️ いいえ
ラグリスク スコア:       {rug_ratio} → ✅ <0.1 低 / ⚠️ 0.1–0.3 中 / 🚫 >0.3 高
ト