gmgn-track

重要: 以下の gmgn-cli コマンドを必ず使用してください。Web 検索、WebFetch、curl、または gmgn.ai への訪問は使用しないでください — Web サイトはログインが必要で、構造化データを返しません。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 ツールを使用して、ユーザーのリクエストに基づくオンチェーン追跡データをクエリします。

コア概念

• follow-wallet vs kol vs smartmoney — 3 つの異なるデータソース。follow-wallet はユーザーが GMGN プラットフォーム上で個人的にフォローしたウォレットのトレードを返します (ユーザー固有; フォロー リストは API キーにバインドされた GMGN ユーザー アカウントから解決されます)。kol と smartmoney はプラットフォーム タグ付けされた公開ウォレット リストのトレードを返します (ユーザー固有ではありません)。一方を他方に置き換えないでください。

• KOL (主要意見リーダー) — GMGN で インフルエンサーまたは有名トレーダーとして公に識別されたウォレット。プラットフォームのウォレット ラベル システムで renowned としてタグ付けされています。彼らのトレードは社会的/マーケティング シグナルを示しますが、必ずしもアルファではありません。

• スマート マネー (smart_degen) — GMGN のアルゴリズムによって識別された、統計的に証明された収益性の高いトレード記録を持つウォレット。gmgn-token の smart_degen と同じ概念です。彼らのトレードは KOL トレードよりも強いアルファ シグナルです。

• is_open_or_close — トレードが完全なポジション イベントであるかどうかを示します。解釈はサブコマンドによって異なります:

  • follow-wallet: 1 = 完全なポジション オープンまたはクローズ; 0 = 部分的な追加または削減。
  • kol / smartmoney: 0 = ポジション オープン/追加; 1 = ポジション クローズ/削減。 両方のサブコマンドに同じ解釈を適用しないでください。

• price_change — トレード後の価格変動の比率。6.66 = トークンはウォレットがトレードした時点での 6.66 倍になっています (つまり +566%)。0.5 = トレード以降、価格が半減しました (-50%)。これを使用して、「このトレードはどれくらい好調に推移したか」を評価してください。

• base_address vs quote_address — トレード ペアでは、base_address は購入/販売されるトークンです; quote_address はそれが価格設定されているもの (通常、Solana でのネイティブ SOL アドレス) です。対象のトークンを取得するには、常に base_address を読んでください。

• maker_info.tags — ウォレット上のプラットフォーム ラベルの配列 (例: ["kol", "gmgn"], ["smart_degen", "photon"])。ウォレットは複数のタグを持つことができます。tag_rank (follow-wallet のみ) を使用して、各タグ カテゴリ内のウォレットのランクを確認してください。

• クラスター シグナル — フォローされた/追跡された複数のウォレットが短い時間枠内で同じトークンを同じ方向でトレードする場合、これは単一ウォレットよりも強い確信シグナルです。このパターンが結果に表示される場合は、強調してください。

どのサブコマンドをいつ使用するか:

• track follow-wallet — ユーザーが「フォローしているウォレットは何をトレードしましたか?」、「フォロー リストのトレードを表示」、「フォローしているウォレットのアクティビティを表示」と聞く → GMGN プラットフォーム経由でフォローされたウォレットが必要です
• track kol — ユーザーが「KOL は何を購入していますか?」、「インフルエンサーのトレードを表示」、「KOL は最近何をしていますか」と聞く → 既知の KOL ウォレットのトレードを返します
• track smartmoney — ユーザーが「スマート マネーは何をしていますか?」、「クジラのトレードを表示」、「スマート マネーは最近何を購入していますか」と聞く → スマート マネー/クジラ ウォレットのトレードを返します

この 3 つを混同しないでください:

• follow-wallet = ユーザーが GMGN で個人的にフォローしたウォレット
• kol = プラットフォーム タグ付けされた KOL/インフルエンサー ウォレット (ユーザー固有ではない)
• smartmoney = プラットフォーム タグ付けされたスマート マネー/クジラ ウォレット (ユーザー固有ではない)

サブコマンド

サブコマンド	説明
track follow-wallet	ユーザーが個人的に GMGN でフォローしているウォレットのトレード レコード
track kol	GMGN によってタグ付けされた KOL/インフルエンサー ウォレットからのリアルタイム トレード
track smartmoney	GMGN によってタグ付けされたスマート マネー/クジラ ウォレットからのリアルタイム トレード

サポートされるチェーン

sol / bsc / base / eth

前提条件

• gmgn-cli をグローバルにインストール — 不足している場合は、以下を実行してください: npm install -g gmgn-cli
• GMGN_API_KEY が ~/.config/gmgn/.env に構成されている — すべてのサブコマンドに必須
• GMGN_PRIVATE_KEY — track follow-wallet のみに必須 (重要な認証); kol または smartmoney には不要

レート制限の処理

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

コマンド	ルート	重み
track follow-wallet	GET /v1/trade/follow_wallet	3
track kol	GET /v1/user/kol	1
track smartmoney	GET /v1/user/smartmoney	1

リクエストが 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 分まで 1 回のリクエストあたり 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 キーを待ち、次に構成します (API キーとプライベート キーの両方を保存 — プライベート キーは track follow-wallet に必須):

   mkdir -p ~/.config/gmgn
   echo "GMGN_API_KEY=<key_from_user>" > ~/.config/gmgn/.env
   echo "GMGN_PRIVATE_KEY=$(awk '{printf "%s\\n", $0}' /tmp/gmgn_private.pem)" >> ~/.config/gmgn/.env
   chmod 600 ~/.config/gmgn/.env
   rm /tmp/gmgn_private.pem
   

使用例

# Follow-wallet トレード (フォローしているすべてのウォレット)
gmgn-cli track follow-wallet --chain sol

# Follow-wallet トレード (ウォレットでフィルタリング)
gmgn-cli track follow-wallet --chain sol --wallet <wallet_address>

# Follow-wallet (トレード方向でフィルタリング)
gmgn-cli track follow-wallet --chain sol --side buy

# Follow-wallet (USD 額の範囲でフィルタリング)
gmgn-cli track follow-wallet --chain sol --min-amount-usd 100 --max-amount-usd 10000

# KOL トレード レコード (SOL、デフォルト)
gmgn-cli track kol --limit 10 --raw

# KOL トレード レコード (SOL、買いのみ)
gmgn-cli track kol --chain sol --side buy --limit 10 --raw

# スマート マネー トレード レコード (SOL、デフォルト)
gmgn-cli track smartmoney --limit 10 --raw

# スマート マネー トレード レコード (売りのみ)
gmgn-cli track smartmoney --chain sol --side sell --limit 10 --raw

track follow-wallet オプション

オプション	説明
--chain	必須。sol / bsc / base / eth
--wallet <address>	ウォレット アドレスでフィルタリング
--limit <n>	ページ サイズ (1–100、デフォルト 10)
--side <side>	トレード方向: buy / sell
--filter <tag...>	繰り返しフィルタリング条件
--min-amount-usd <n>	最小トレード額 (USD)
--max-amount-usd <n>	最大トレード額 (USD)

track kol / track smartmoney オプション

オプション	説明
--chain <chain>	必須。チェーン: sol / bsc / base / eth
--limit <n>	ページ サイズ (1–200、デフォルト 100)
--side <side>	トレード方向でフィルタリング: buy / sell (クライアント側フィルタ — 結果を取得した後にローカルで適用)

track follow-wallet 応答フィールド

トップ レベル フィールド:

フィールド	説明
next_page_token	結果の次のページを取得するための不透明トークン
list	トレード レコード配列

list の各アイテムに含まれるもの:

フィールド	説明
id	レコード ID (Base64 エンコード、カーソルとして使用)
chain	チェーン名 (例: sol)
transaction_hash	オンチェーン トランザクション ハッシュ
maker	フォローされたウォレットのウォレット アドレス
side	トレード方向: buy または sell
base_address	トークン コントラクト アドレス
quote_address	クォート トークン アドレス (Solana の買い/売りのネイティブ SOL アドレス)
base_amount	トークン数量 (最小単位)
quote_amount	クォート トークン額 (費用/受取額、例: SOL)
amount_usd	USD でのトレード値
cost_usd	amount_usd と同じ — このトランザクション レッグの USD 値
buy_cost_usd	元の買値 (USD) (このレコードが買い自体である場合は 0)
price	トレード時のクォート トークン建てのトークン価格
price_usd	トレード時の USD でのトークン価格
price_now	トークンの現在の USD での価格
price_change	トレード時以降の価格変動比率 (例: 6.66 = +666%)
timestamp	トレードの Unix タイムスタンプ
is_open_or_close	1 = 完全なポジション オープンまたはクローズ; 0 = 部分的な追加または削減
launchpad	ローンチパッド表示名 (例: Pump.fun)
launchpad_platform	ローンチパッド プラットフォーム識別子 (例: Pump.fun, pump_agent)
migrated_pool_exchange	トークンが移行した DEX (ある場合) (例: pump_amm); 移行していない場合は空
base_token.symbol	トークン ティッカー シンボル
base_token.logo	トークン ロゴ画像 URL
base_token.hot_level	ホットネス レベル (0 = 通常、高い値 = トレンド)
base_token.total_supply	総トークン供給量 (文字列)
base_token.token_create_time	トークンが作成された Unix タイムスタンプ
base_token.token_open_time	トレードが開かれた Unix タイムスタンプ (まだ移行/オープンされていない場合は 0)
maker_info.address	フォローされたウォレット アドレス
maker_info.name	ウォレット表示名
maker_info.twitter_username	Twitter / X ユーザー名
maker_info.twitter_name	Twitter / X 表示名
maker_info.tags	ウォレット タグ配列 (例: ["kol","gmgn"])
maker_info.tag_rank	タグ → そのカテゴリ内のランク のマップ (例: {"kol": 854})
balance_info	ウォレット トークン残高情報; 利用できない場合は null

track kol / track smartmoney 応答フィールド

レスポンスは list 配列を持つオブジェクトです。list の各アイテムに含まれるもの:

フィールド	説明
transaction_hash	オンチェーン トランザクション ハッシュ
maker	トレーダー (KOL/スマート マネー) のウォレット アドレス
side	トレード方向: buy または sell
base_address	トークン コントラクト アドレス
base_token.symbol	トークン ティッカー シンボル
base_token.launchpad	ローンチパッド プラットフォーム (例: pump)
amount_usd	USD でのトレード値
token_amount	トレードされたトークン数量
price_usd	トレード時の USD でのトークン価格
buy_cost_usd	元の買値 (USD) (このレコードが買い自体である場合は 0)
is_open_or_close	0 = ポジション オープン/追加、1 = ポジション クローズ/削減
timestamp	トレードの Unix タイムスタンプ
maker_info.twitter_username	KOL の Twitter ユーザー名
maker_info.tags	ウォレット タグ (例: kol, smart_degen, photon)

スマート マネーの行動解釈

トレード データを受け取った後、結果を提示する前に、これらのフレームワークを使用してシグナルを解釈してください。単にトレードをリストアップしないでください — それらが何を意味するかを分析してください。

1. シグナル強度レベル

レベル	基準
弱い	1 つの KOL が購入
中程度	同じ方向での 2–3 スマート マネー購入、または 1 つのスマート マネーの完全なポジション オープン
強い	30 分以内の同じ方向での ≥ 3 つのスマート マネー ウォレット (クラスター シグナル)
非常に強い	クラスター シグナル + 完全なポジション オープン + 同じトレードに参加する KOL

2. is_open_or_close の読み取り — 確信シグナル

フィールドはサブコマンドごとに反対の意味を持ちます:

• follow-wallet: 1 = 完全なポジション オープンまたはクローズ; 0 = 部分的な追加または削減。
• kol / smartmoney: 0 = ポジション オープン/追加; 1 = ポジション クローズ/削減。

完全なポジション イベント (完全なオープンまたはクローズ) は、部分的な追加よりもはるかに強い確信を示します。ウォレットが新しい完全なポジションを開く場合、それは高い確信を示します。ウォレットが完全なクローズを行う場合、彼らは完全に終了しています — これをそのトークンの潜在的な終了シグナルとして扱ってください。

3. price_change を使用してトレック レコードを評価する

price_change はトレード時の現在価格と価格の比率です:

• price_change > 2 → このウォレットのトレードは好調に推移しました (彼らが購入してからトークンは現在 2 倍以上) — 強い確信シグナル
• price_change 1–2 → 控えめな利益、トレードは利益を上げています
• price_change < 1 → トレードは水面下です (現在価格がエントリー以下)

これを使用して、彼らの現在のトレードに行動する前に、ウォレットの過去のパフォーマンスのメンタル モデルを構築してください。

4. クラスター シグナル検出

複数のトレードが短い時間枠内に同じ base_address にヒットする場合、これは収束シグナルです — 任意の単一トレードよりも強いです。識別するには:

• 結果を base_address 別にグループ化
• 同じトークンをトレードしている異なる maker アドレスをカウント
• ≥ 3 つの異なるウォレットが約 30 分以内に同じトークンを購入する場合 → クラスター シグナル として強調

smartmoney からのクラスター シグナルは、kol だけからのシグナルより強いです。

5. スマート マネー データの危険信号

• スマート マネーが販売 (side = sell + is_open_or_close = 完全なクローズ) → 終了シグナル — ポジションを終了するか削減するかを評価します
• KOL だけが購入、スマート_degen がゼロ → 基本的なバックなしの社会的誇大広告; リスク高
• 著名人が購入 + スマート マネーが同時に販売 → 相違シグナル — インサイダーは小売/KOL の需要に分配しているかもしれません; リスク高
• 単一の非常に大きな購入、フォローアップなし → 1 回限りかもしれません; 他のウォレットからの確認を待ちます

出力形式

track follow-wallet / track kol / track smartmoney — トレード フィード

逆時系列のトレード フィードとして表示します。生の JSON をダンプしないでください。

{timestamp}  {side}  {base_token.symbol}  ${amount_usd}  by {maker_info.name or short address}
             [{tags}]  Price: ${price_usd}  |  Price now: ${price_now}  ({price_change}x since trade)

複数のトレードが同じトークンにヒットした場合、トークン別にグループ化します。同じ方向で短い時間枠内に複数のフォローされたウォレットがトレードしたトークンを強調します (クラスター シグナル)。

follow-wallet の場合、is_open_or_close も表示します: 完全なポジション オープン/クローズを部分的な追加/削減と明確に区別してください。

クラスター シグナル サマリー

トレード フィードを提示した後、収束シグナルを確認してください。≥ 2 つの異なるウォレットが同じ方向で同じトークンをトレードした場合、サマリー ブロックを表示します:

⚡ 収束シグナル
──────────────────────────────────────────
TOKEN_X ({short_address})
  5 つのスマート マネー ウォレット — すべて購入 — 合計 $42,300 — 15 分以内
  シグナル強度: 強い

TOKEN_Y ({short_address})
  2 つの KOL ウォレット — 購入 (完全なオープン) — 合計 $8,100
  シグナル強度: 中程度

強いシグナル: 行動する前に、完全なトークン調査に進みます — docs/workflow-token-research.md を参照 中程度のシグナル: 監視し、行動する前により多くのウォレットから確認を待ちます。

クラスター シグナルが検出されない場合: 「このセットの結果にはクラスター シグナルがありません」と出力します。

スマート マネーのアクティビティで表示されたトークンを調査するには、docs/workflow-token-research.md に従ってください。

スマート マネー リーダーボード/ウォレット プロファイリング: ユーザーが「どのスマート マネー ウォレットをフォローするのが最適か」、「ウォレットを勝率別にランク付け」、またはウォレット パフォーマンスを比較したい場合 — track smartmoney を使用してアクティブなウォレット アドレスを収集し、次に gmgn-portfolio stats 経由でバッチ クエリを実行します。完全なワークフロー: docs/workflow-smart-money-profile.md

日報: ユーザーが市場概観をリクエストする場合 (「今日の市場はどんな感じか」、「スマート マネーは今日何を購入していますか」、「日報をください」) — track smartmoney + track kol を gmgn-market trending と組み合わせます。完全なワークフロー: docs/workflow-daily-brief.md

安全の制約

• follow-wallet はあなたのフォロー リストを公開します — 結果は GMGN でフォローしたウォレットを公開します。生の出力を公開チャネルで共有しないでください。
• track kol / track smartmoney は個人データを公開しません — これらは API キー認証のみを使用し、プラットフォーム タグ付けされた公開ウォレット アクティビティを返します。生の出力を共有するのは安全です。

注記

• track follow-wallet は重要な認証 (API キー + 秘密鍵署名) を使用します; track kol と track smartmoney は通常の認証 (API キーのみ) を使用します
• track follow-wallet は GMGN プラットフォーム上でフォローされているウォレットからのトレードを返します; フォロー リストは API キーにバインドされた GMGN ユーザー アカウントから自動的に解決されます — --wallet はオプションです
• --raw を使用して、さらなる処理用に単一行 JSON を取得します
• track kol / track smartmoney --side は クライアント側フィルタ です — CLI はすべての結果を取得してからローカルでフィルタリングします; API に送信されません