GMGN Skills

GMGN Agent Skills

GMGN Agent Skills を使用すると、AI エージェントを使って、複数チェーンにわたるリアルタイムのトレンドトークンランキング、トークンのファンダメンタルズ、ソーシャルメディアのシグナル、ライブの取引アクティビティ、Trenches の新規トークン、トップ保有者、トップトレーダー、スマートマネーのポジション、KOL の保有資産、インサイダーウォレット、バンドルウォレットのエクスポージャー、その他のプロフェッショナルなオンチェーン分析を照会できます。また、成行注文、指値注文、高度な利確・損切り戦略注文、ワンコマンドのクッキング注文(買い+条件注文を1つのフローで実行)、ウォレット管理(リアルタイムの保有資産、直近の損益、取引履歴を含む)も、すべて自然言語を通じてサポートします。

---

GMGN Skills を選ぶ理由

複数チェーンの Meme トークンをリアルタイムかつ高速に照会・取引するために AI エージェント向けに構築されています。gmgn-skills は、AI エージェントに GMGN のトレンドトークン、Trenches の新規トークン上場情報、プロフェッショナルなオンチェーンデータ(Smart Money、KOL、rat trader、バンドラー分析を含む)への直接アクセスを提供します。

500 以上のプロフェッショナルなデータディメンションを備えており、AI エージェントを 24 時間 365 日稼働するリアルタイムのチェーンスキャン取引ツールに変えることができます。複数チェーンのトークンの勢いを監視し、即座に注文を出し、利確・損切りで出口を管理する — すべてを自動で行えます。

1. リアルタイムのオンチェーンデータ — より高速に

SOL / BSC / Base / ETH のデータは、クエリごとにライブで取得されます。マルチパラメータのカスタマイズをサポートし、スナップショットキャッシュは使用しません — AI エージェントのリアルタイム意思決定のために構築されています(以下に限定されません):

データ	粒度
新規トークンの検出 (Trenches)	リアルタイム、ローンチパッド、Dev の保有資産、KOL の参入、rat trader 比率でフィルタリング
トレンドトークン	リアルタイム、1m / 5m / 1h / 6h / 24h — 最小 1分 のウィンドウ
トークン情報	リアルタイム — 取引アクティビティ / 価格 / 出来高 / 時価総額
トークンのセキュリティ	リアルタイム — オープンソース、放棄、ハニーポット検出など
トークン分析	リアルタイム — Dev / KOL / Smart Money / rat trader / バンドラーウォレットの保有資産
監視・トラッキング	リアルタイム — KOL / Smart Money / フォロー中のウォレットの取引アクティビティ
Kライン (OHLCV)	リアルタイム、1m / 5m / 15m / 1h / 4h / 1d — 最小 1分 のローソク足
ウォレットの保有資産	リアルタイム — 保有資産 / 損益 / 取引アクティビティ

2. より高速な取引

• GMGN の Web 取引インターフェースと同じ RPC ルーティング、マルチリージョン展開、ミリ秒単位の応答 — 注文送信はエンドツーエンドで 0.3秒 未満。
• 最適ルートの自動選択、GMGN Web と同じルーティングエンジン。
• 成行注文、指値注文、戦略注文(利確 / 損切り)を 1 つのコマンドで。
• ポジションのパーセンテージで売却(--percent 50)、正確な数量を計算する必要なし。

注文タイプ	説明
成行注文	現在の市場価格で即時約定
指値注文	指定価格で買いまたは売りをトリガー
利確 / 損切り	スワップに付随する固定価格の決済条件
トレーリング利確 / トレーリング損切り	価格のピークを追跡し、指定のドローダウン % 後に発動 — 勢いに乗りながら利益を保護
マルチウォレット一括取引	複数のウォレットで同時に買い、それぞれに独自の利確 / 損切り / トレーリング利確 / トレーリング損切りの注文を設定

3. より包括的なトークンデータ

もうウェブページをスクレイピングしたり、Cloudflare にブロックされたりする必要はありません。高頻度の Meme トークン取引に必要なプロフェッショナルな分析を、高い並行性でリアルタイムにすべてクエリできます（以下に限定されません）：

• スマートマネー数（smart_degen_count）と KOL 保有者（renowned_wallets）— ライブ
• ラットトレーダー比率（rat_trader_amount_rate）— インサイダー／スニークウォレットからの出来高シェア
• バンドラーボットの露出（bundler_trader_amount_rate）— ボットが束ねた買いによる出来高
• スナイパーウォレット（sniper_count）— ローンチのまさにその瞬間に購入したウォレット
• インサイダー容疑保有率（suspected_insider_hold_rate）
• フレッシュウォレット比率（fresh_wallet_rate）
• Rug 比率スコア（0〜1）+ ハニーポット検出 + ウォッシュトレードフラグ
• ボンディングカーブのステータス（is_on_curve）— トークンがオープン DEX に卒業したかどうか

4. GMGN Skills でできること

リアルタイムチェーンスキャン

• Trenches で新規トークンをスキャンし、ローンチパッド（Pump.fun、letsbonk、fourmeme、clanker…）、開発者保有分、KOL の参入、ラットトレーダー比率でリアルタイムにフィルタリング
• マルチチェーンのトレンドトークンランキングを閲覧（最小 1 分粒度）、出来高、スマートマネー数、時価総額などで並べ替え
• 新規トークンをリアルタイムに追跡 — KOL、スマートマネー、フォロー中のウォレットがどのトークンを買っているかを確認し、最新の注目トークンを自動分析
• 任意のトークンのリアルタイム K ライン／OHLCV データを取得（1m / 5m / 15m / 1h / 4h / 1d）

トークン分析

• トークンのファンダメンタルズ、ソーシャルリンク、ボンディングカーブのステータス、流動性プールの詳細をクエリ
• セキュリティチェック：オープンソース、renounced、ハニーポット、ウォッシュトレード、Rug 比率スコア（0〜1）
• 詳細な保有者分析：スマートマネー／KOL／ラットトレーダー／バンドラー／スナイパー／クジラ／フレッシュウォレット — 保有内訳とランキング

ウォレットと追跡

• 任意のウォレットを分析：リアルタイムの保有状況、実現／未実現の損益、勝率、取引スタイル、全履歴
• スマートマネー、KOL、フォロー中のウォレットによる最新の買いと売りをリアルタイムに追跡

自動取引

• 成行注文、指値注文、利確／損切り戦略注文 — エンドツーエンドのレイテンシは 0.3 秒未満
• ポジション比率を指定したワンコマンド売却（--percent 50）、手動計算は不要

AI ワークフロー

• 9 種類の組み込みワークフロードキュメント：トークンリサーチ、プロジェクト詳細レポート、ウォレット分析、スマートマネープロファイリング、リスク警告、初期プロジェクトスクリーニング、デイリーブリーフ、マーケットディスカバリーなど — すぐに使えます

---

スキル

スキル	説明	参照
/gmgn-token	トークン情報、セキュリティ、プール、保有者、トレーダー	SKILL.md
/gmgn-contract-dd	1つのトークンアドレスを対象としたコントラクトのデューデリジェンススコア。安全性、保有者の構成、価格動向を0～100の単一評価にまとめます	SKILL.md
/gmgn-holder-analysis	トークン保有者のチップ分析。チップの分布、取得コスト、クジラ／開発者／KOLの行動、リスクのあるウォレット	SKILL.md
/gmgn-market	K線市場データ、トレンドトークン	SKILL.md
/gmgn-portfolio	ウォレットの保有資産、アクティビティ、統計	SKILL.md
/gmgn-wallet-analysis	ウォレットの判定レポート。4つの合否ゲートに加え、ウォレットが現在保有・購入している資産を示します	SKILL.md
/gmgn-wallet-score	ウォレットのコピートレードスコアリング。取引実績、コピートレード適性、バックテスト、開発者の評判	SKILL.md
/gmgn-wallet-style	ウォレットの取引スタイルタグ。頻度×損益による20種類のタイトル、速度のサブタイトル、バッジを、それぞれ判定の根拠となる数値とともに表示します	SKILL.md
/gmgn-wallet-review	ウォレットの取引プロファイル。1D／7D／30D／全期間ごとに、スタイルタグ1つ、1文の振り返り、1文の次のステップを提示します	SKILL.md
/gmgn-track	ウォレット、KOL、スマートマネーの取引を追跡	SKILL.md
/gmgn-callout	コールアウト（喊单）。1つのウォレットのコールアウト履歴と7日／30日の的中率、KOL／宣言／安全／保有フィルター付きの全体コールアウトフィード	SKILL.md
/gmgn-token-buy	買い手側のデューデリジェンス。トークン名から適切なコントラクトを特定し、3つの必須ゲート、スリッページとガスの見積もりを行い、注文カードをgmgn-swapに引き渡します	SKILL.md
/gmgn-swap	スワップの送信＋指値注文＋ストラテジー注文＋注文照会	SKILL.md
/gmgn-cooking	ワンコマンドの調理注文（1つのフローで購入＋利確／損切り）	SKILL.md
/gmgn-kline-pattern	値動きパターンの読み取り。チャートパターンを特定し、0～100でスコア化します	SKILL.md

CLIコマンド、パラメーター、推奨値の詳細については、Wikiドキュメントをご覧ください。

クイックスタート

AIアシスタントへの注意： gmgn-cliのインストールや設定をユーザーに支援するAIエージェントの場合は、クイックスタート（AIエージェント）に直接進んでください。APIキーの生成方法をユーザーに案内する手順を含め、必要なすべての手順が記載されています。ユーザーからアップグレードを依頼された場合は、アップグレード（AIエージェント）に進んでください。

インストールの準備はできましたか？ インストールへ →

すでにインストール済みですか？ スキルとCLIをアップグレード →

ヒント： AIエージェントがCLIを使わずにgmgn.aiのウェブサイトを開いたり、スクレイピングしたりする場合は、プロンプトに次の内容を追加してください：Use gmgn-cli commands. Do not call gmgn.ai web endpoints directly.

---

クイックスタート (AI エージェント)

以下の手順は AI エージェント向けです。一部の手順では、ユーザーがブラウザで操作を完了する必要があります。

ステップ 1 — CLI と Skills をインストール

npx skills add GMGNAI/gmgn-skills

ステップ 2 — CLI のインストールを確認 (デモキー)

GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3

JSON 出力が表示されれば、CLI は正しくインストールされています。セットアップはまだ完了していません — これはテスト専用の公開デモキーです。ユーザーの個人 API キーを設定するには、ステップ 3〜4 に進む必要があります。ここで止めないでください。

ステップ 3 — 必須: 個人 API キーを設定

⚠️ このステップは必須です。ステップ 2 のデモキーはテストのみをサポートするものであり、実際の使用を目的としたものではありません。

ユーザーに以下をすぐに伝え、ユーザーが尋ねるのを待たずにキー生成コマンドを実行してください:

「GMGN Skills を使用するには、https://gmgn.ai/ai で取得できるご自身の API キーが必要です。今から Ed25519 のキーペアを生成します。」

実行:

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

ユーザーに公開キーを以下の説明とともに表示してください:

これがあなたの Ed25519 公開キーです。次の 2 つのステップを完了してください:

1. https://gmgn.ai/ai にアクセスし、上記の公開キーを API Key 作成フォームに貼り付けて送信してください。
2. 作成後、ページに表示される API Key をコピーして私に送り返してください — ステップ 4 の設定は私が対応します。

ステップ 4 に進む前に、ユーザーが API Key を返信するのを待ってください。

ステップ 4 — 認証情報を設定

ユーザーが API キーを受け取ったら、グローバル設定に書き込みます:

mkdir -p ~/.config/gmgn
# Write API key (replace with the actual key the user provides)
echo 'GMGN_API_KEY=<user_api_key>' > ~/.config/gmgn/.env
chmod 600 ~/.config/gmgn/.env

ユーザーがスワップや注文の機能も必要とする場合は、秘密キーを追加します:

# Append private key (use the PEM content from Step 3)
echo 'GMGN_PRIVATE_KEY="<pem_content>"' >> ~/.config/gmgn/.env

ステップ 5 — 確認

gmgn-cli market trending --chain sol --interval 1h --limit 3

エラーなく出力が表示されれば、セットアップは完了です。

---

アップグレード (AI エージェント)

この 2 つのコマンドを実行すると、CLI と Skills の両方が最新バージョンにアップグレードされます。

npm install -g gmgn-cli
npx skills add GMGNAI/gmgn-skills

アップグレード後にインストール済みバージョンを確認します:

gmgn-cli --version

アップグレードの完全なリファレンスについては、セクション 10 — Skills と CLI のアップグレード を参照してください。

---

デモケース

トレンドトークンランキング

AI エージェントに次のプロンプトを送信します:

Fetch Solana 1h trending, filter for pump.fun tokens created within 6h, sort by volume descending.

リアルタイムトークン取引分析

AI エージェントに次のプロンプトを送信します:

Check the first token's K-line, analyze entry timing, plot price + volume chart, and provide social media links and smart money/KOL trading analysis.

---

1. インストール

前提条件: インストールする前に、https://gmgn.ai/ai で API Key を作成してください (完全なセットアップガイドは セクション 3 を参照)。

以下のいずれかの方法を選択してください:

1.1 エージェント経由 (推奨)

AI エージェントにこれを送信します:

npx skills add GMGNAI/gmgn-skills

1.2 npm グローバルインストール

npm install -g gmgn-cli

1.3 ローカル開発

npm install
npm run build
node dist/index.js <command> [options]

2. 接続を確認

公開 API キーでテストします — 登録は不要です:

GMGN_API_KEY=gmgn_solbscbaseethmonadtron gmgn-cli market trending --chain sol --interval 1h --limit 3

JSON 出力が表示されれば、CLI は動作しています。公開キーはすべての読み取り専用コマンド (token / market / portfolio) をサポートしており、テスト専用です — あらゆる機能を使用するにはご自身の API キーを申請してください (ステップ 3 を参照)。

トラブルシューティング — 401 / 403 エラー: コマンドが 401 または 403 で失敗し、認証情報が正しいように見える場合、送信トラフィックが IPv6 経由になっている可能性があります (サポート対象外)。すぐに確認してください: (1) ifconfig | grep inet6 (macOS) または ip addr show | grep inet6 (Linux) を実行して、すべてのネットワークインターフェースとその IPv6 アドレスを一覧表示します。(2) curl -s https://ipv6.icanhazip.com を実行します — IPv6 アドレスが返される場合、トラフィックは IPv6 経由です。ネットワークインターフェースで IPv6 を無効にしてください — gmgn-cli コマンドは IPv4 経由でのみ動作します。

3. ご自身の API キーを取得

ステップ 2 の公開キーはテスト専用です。https://gmgn.ai/ai でご自身の API キーを申請してください — すべての実際の使用 (読み取り専用およびスワップ) に必要です。必要なもの:

3.1 Ed25519 キーペアを生成

オプション 1 — AI エージェントに依頼 (推奨)

エージェントに次のプロンプトを送信します:

Generate an Ed25519 key pair for me using OpenSSL and show me:
1. The public key (I need to fill it in the GMGN API Key application form)
2. The private key in PEM format (I need to set it as GMGN_PRIVATE_KEY in my .env)

オプション 2 — Binance Key Generator

Binance Asymmetric Key Generator をダウンロードして実行します。

申請フォームに公開キーを入力します。

3.2 パブリック送信 IP の取得

IP ホワイトリスト用です（API キーでスワップ機能を有効にする際に必要です）。

curl ip.me

4. API キーの設定

オプション 1：グローバル設定（推奨）

~/.config/gmgn/.env を一度作成すれば、どのディレクトリからでも使用できます。

mkdir -p ~/.config/gmgn
cat > ~/.config/gmgn/.env << 'EOF'
GMGN_API_KEY=your_api_key_here

# Required for swap / order only:
GMGN_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n<base64>\n-----END PRIVATE KEY-----\n"
EOF

オプション 2：プロジェクトの .env

cp .env.example .env
# Edit .env and fill in your values

設定の検索順序：~/.config/gmgn/.env → プロジェクトの .env（プロジェクト側が優先されます）。シェルですでにエクスポートされている変数は、両方のファイルより優先されます。

5. AI クライアントで試す

OpenClaw

クエリ機能をテストするには、次のプロンプトを直接送信します。

Show me the trending tokens on Solana in the last 1 hour.

Claude Code

パッケージをプラグインとしてインストールすると、スキルが自動的に検出されます。

Cursor

.cursor-plugin/ の設定を通じて、スキルが自動的に検出されます。

1. 上記のインストールと設定の手順を完了します
2. Cursor を再起動します。スキルはエージェントモードで /gmgn-* コマンドから使用できます

Cline

1. 上記のインストールと設定の手順を完了します
2. Cline の設定 → スキルディレクトリ：インストール済みパッケージの skills/ フォルダーを指定します。

   echo "$(npm root -g)/gmgn-skills/skills"
   

3. Cline を再起動すると、/gmgn-token、/gmgn-market、/gmgn-portfolio、/gmgn-wallet-score、/gmgn-track、/gmgn-swap、/gmgn-cooking が使用できるようになります

Codex CLI

git clone https://github.com/GMGNAI/gmgn-skills ~/.codex/gmgn-cli
mkdir -p ~/.agents/skills
ln -s ~/.codex/gmgn-cli/skills ~/.agents/skills/gmgn-cli

詳しい手順については、.codex/INSTALL.md を参照してください。

OpenCode

git clone https://github.com/GMGNAI/gmgn-skills ~/.opencode/gmgn-cli
mkdir -p ~/.agents/skills
ln -s ~/.opencode/gmgn-cli/skills ~/.agents/skills/gmgn-cli

詳しい手順については、.opencode/INSTALL.md を参照してください。

---

6. 使用方法

例

gmgn-cli スキルをインストールした任意の AI アシスタントに送信できる、自然言語のプロンプトです。

buy 0.1 SOL of <token_address>
sell 50% of <token_address> on BSC
sell 30% of my <token_address> position
get a quote: how much <token_address> can I get for 1 SOL?
check order status <order_id>
is <token_address> safe to buy on solana?
show top holders of <token_address>
show smart money holdings of <token_address>, sorted by buy volume
show recent KOL trades for <token_address>
show my wallet holdings on SOL
query token details for 0x1234...
show 24h K-line and volume for <token_address>
show trading stats for wallet <wallet_address> on BSC
show recent trades for wallet <wallet_address>
which wallets are linked to my API key, and what are their balances
show the latest smart money trades on SOL
show what KOLs are buying on SOL
show newly launched tokens on Solana
show Solana 1-minute trending tokens

一般的なワークフロー

トークンを調査する：

token info  →  token security  →  token pool  →  token holders

ウォレットを分析する：

portfolio holdings  →  portfolio stats  →  portfolio activity

取引を実行する：

token info (confirm token)  →  portfolio token-balance (check funds)  →  swap  →  order get (poll status)

トレンドから取引機会を見つける：

market trending (top 50)  →  AI selects top 5 by multi-factor analysis  →  user reviews  →  token info / token security  →  swap

---

7. ワークフローのドキュメント

一般的な分析タスクの手順ガイドです。

ワークフロー	使用するタイミング
workflow-token-research.md	購入前のトークンのデューデリジェンス（アドレス → 購入／ウォッチ／見送り）
workflow-project-deep-report.md	評価項目ごとのスコアと詳細なレポートを含む、プロジェクトの包括的な分析
workflow-wallet-analysis.md	ウォレットの品質評価（アドレス → フォロー／見送り）
workflow-smart-money-profile.md	取引スタイルの分析、コピー取引の ROI 推定、スマートマネーのリーダーボード
workflow-risk-warning.md	保有ポジションの継続的なリスク監視（クジラの売却、流動性、開発者の売り抜け）
workflow-early-project-screening.md	新規ローンチされたローンチパッドのトークンをスクリーニングし、スマートマネーの参入を確認
workflow-daily-brief.md	日次の市場概要：トレンド＋スマートマネーの動向＋初期段階のウォッチ＋リスクスキャン
workflow-market-opportunities.md	トレンドデータから取引機会を見つける
workflow-token-due-diligence.md	4 ステップのトークン・デューデリジェンス・チェックリスト

8. CLI リファレンス

全パラメーターのリファレンス：docs/cli-usage.md。すべてのコマンドで --raw を指定すると、1 行の JSON を出力できます（パイプ処理向け。例：| jq '.price'）。

トークン

gmgn-cli token info --chain sol --address <addr>

市場

gmgn-cli market trending \
  --chain sol \
  --interval 1h \
  --order-by volume --limit 20 \
  --filter not_risk --filter not_honeypot

# Trending with numeric range filters (min_*/max_* are forwarded as query params)
gmgn-cli market trending \
  --chain sol --interval 1h \
  --min-liquidity 10000 --max-liquidity 1000000 \
  --max-created 30m --min-smart-degen-count 1 \
  --order-by volume --limit 30

gmgn-cli market trenches \
  --chain sol \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform letsbonk \
  --limit 80

# With server-side filters: safe preset + require smart money + sort by smart degen count
gmgn-cli market trenches \
  --chain sol --type new_creation \
  --filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count

# Token signals — smart money buys on SOL (single group)
gmgn-cli market signal --chain sol --signal-type 12 --raw

# Token signals — multi-group: smart money OR large buys in parallel
gmgn-cli market signal --chain sol \
  --groups '[{"signal_type":[12]},{"signal_type":[14,16]}]' --raw

# Hot searches — most-searched tokens (default 9-chain set, 24h)
gmgn-cli market hot-searches --raw

# Hot searches — SOL only, 1h window, top 50
gmgn-cli market hot-searches --chain sol --interval 1h --limit 50 --raw

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

ポートフォリオ

# Holdings
gmgn-cli portfolio holdings --chain sol --wallet <addr>

# Activity
gmgn-cli portfolio activity --chain sol --wallet <addr>

# Stats (supports multiple wallets)
gmgn-cli portfolio stats --chain sol --wallet <addr1> --wallet <addr2>

# P&L (supports 1–100 wallets and 1d/7d/30d/all periods)
gmgn-cli portfolio profits --chain sol --wallet <addr1> --wallet <addr2> --period 7d

# Wallets and balances linked to API key
gmgn-cli portfolio info

# Single token balance
gmgn-cli portfolio token-balance --chain sol --wallet <addr> --token <token_addr>

# Tokens created by a developer wallet
gmgn-cli portfolio created-tokens --chain sol --wallet <addr>

トラッキング

# Followed token map for a wallet
gmgn-cli track follow-tokens --chain sol --wallet <wallet_address>

# Follow-wallet trade records
gmgn-cli track follow-wallet --chain sol
gmgn-cli track follow-wallet --chain sol --limit 20 --min-amount-usd 1000

# KOL trade records
gmgn-cli track kol --limit 100 --raw
gmgn-cli track kol --chain sol --side buy --limit 50 --raw

# Smart Money trade records
gmgn-cli track smartmoney --limit 100 --raw
gmgn-cli track smartmoney --chain sol --side sell --limit 50 --raw

コールアウト

# One wallet's call-out history (last 30 days) + 7d/30d summary
gmgn-cli callout record --chain sol --wallet <wallet_address>
gmgn-cli callout record --chain sol --wallet <wallet_address> --token <token_address> --raw

# Global call-out feed (repeat --chain for multiple chains)
gmgn-cli callout global --chain sol --chain bsc --limit 20 --raw
gmgn-cli callout global --chain sol --only-kol --only-safe --min-holding-usd 1000 --raw

# Next page: pass next_page_token back verbatim
gmgn-cli callout global --chain sol --page-token <next_page_token> --raw

スワップ／見積もり／クエリ

直接実行。 swap、multi-swap、order strategy create、order strategy cancel、cooking create は、オプションの検証後すぐに送信されます。端末でのプロンプト、--yes、GMGN_ALLOW_AUTOMATED_TRADES は不要です。これにより、スケジュール済みの戦略や無人での戦略を運用できます。

# Submit swap with fixed slippage
gmgn-cli swap \
  --chain sol \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
  --slippage 30

# Submit swap with automatic slippage
gmgn-cli swap \
  --chain sol \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
  --auto-slippage

# Sell by position percentage (e.g. sell 50%)
gmgn-cli swap \
  --chain sol \
  --from <wallet-address> \
  --input-token <token-addr> \
  --output-token <usdc-addr> \
  --percent 50 \
  --auto-slippage

# Get quote (no transaction submitted)
gmgn-cli order quote \
  --chain sol \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000 \
  --slippage 30

# Quotes use signed auth and require GMGN_PRIVATE_KEY on every chain
gmgn-cli order quote \
  --chain bsc \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount 1000000000000000000 \
  --slippage 30

# Query order
gmgn-cli order get --chain sol --order-id <order-id>

# Query real-time gas price (all chains)
gmgn-cli gas-price --chain sol
gmgn-cli gas-price --chain eth
gmgn-cli gas-price --chain bsc
gmgn-cli gas-price --chain base

# Multi-wallet concurrent swap
gmgn-cli multi-swap \
  --chain sol \
  --accounts <addr1>,<addr2> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --input-amount '{"<addr1>":"1000000","<addr2>":"2000000"}' \
  --slippage 30

order quote は sol／bsc／base／eth で署名付き認証を使用し、GMGN_PRIVATE_KEY が必要です。

ETH ガス制御（ETH のみ）

# Pick a gas tier instead of entering gwei manually (low / average / high)
gmgn-cli swap \
  --chain eth \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
  --slippage 30 \
  --gas-level high

# Let GMGN auto-select the optimal gas fee for condition orders
gmgn-cli swap \
  --chain eth \
  --from <wallet-address> \
  --input-token <input-token-addr> \
  --output-token <output-token-addr> \
  --amount <amount> \
  --slippage 30 \
  --condition-orders '[...]' \
  --auto-fee

--gas-level と --auto-fee は ETH 専用です。--auto-fee は --condition-orders と併用した場合にのみ有効になります。 その他のチェーン（SOL／BSC／BASE）では、gas-price で現在のガス価格を取得し、その結果を --gas-price に渡してください。

利確／損切り注文を設定してスワップ（秘密鍵が必要）

hold_amount モード — 各条件注文は、トリガー時点の現在の保有量に基づいて発動します。

# Buy token A with 0.01 SOL; take-profit 50% at +100%, take-profit remaining 50% at +300%, stop-loss 100% at -65%
gmgn-cli swap \
  --chain sol \
  --from <wallet_address> \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type hold_amount

profit_stop の price_scale は、エントリー価格からの上昇率です（"100" = +100%／2 倍、"300" = +300%／4 倍）。loss_stop の場合は、エントリー価格からの下落率です（"65" = 65% 下落し、エントリー価格の 35% で発動）。 hold_amount：2 回目の利確注文は、その時点で保有している分（残りの 50%）に対して発動します。その間にポジションを追加していた場合、その追加分のトークンも含まれます。

buy_amount モード — 各条件注文は、最初に購入した数量に基づいて発動します。

# Same strategy using fixed percentages of the original bought amount
gmgn-cli swap \
  --chain sol \
  --from <wallet_address> \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_A_address> \
  --amount 10000000 \
  --slippage 30 \
  --anti-mev \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"50"},{"order_type":"profit_stop","side":"sell","price_scale":"300","sell_ratio":"50"},{"order_type":"loss_stop","side":"sell","price_scale":"65","sell_ratio":"100"}]' \
  --sell-ratio-type buy_amount

buy_amount：各利確注文は、最初に購入した数量の 50% を売却します。損切り注文は、最初に購入した数量の 100% を売却します。

---

指値注文（秘密鍵が必要）

# Create a take-profit order
gmgn-cli order strategy create \
  --chain sol \
  --from <wallet_address> \
  --base-token <token_address> \
  --quote-token <sol_address> \
  --sub-order-type take_profit \
  --check-price 0.002 \
  --amount-in-percent 100 \
  --slippage 30

# Create a stop-loss order
gmgn-cli order strategy create \
  --chain sol \
  --from <wallet_address> \
  --base-token <token_address> \
  --quote-token <sol_address> \
  --sub-order-type stop_loss \
  --check-price 0.0005 \
  --amount-in-percent 100 \
  --slippage 30

# List open strategy orders (requires private key)
gmgn-cli order strategy list --chain sol

# Cancel a strategy order
gmgn-cli order strategy cancel --chain sol --from <wallet_address> --order-id <order_id>

調理（秘密鍵が必要）

# Buy token and automatically attach take-profit + stop-loss condition orders
gmgn-cli cooking \
  --chain sol \
  --from <wallet_address> \
  --input-token So11111111111111111111111111111111111111112 \
  --output-token <token_address> \
  --amount 1000000000 \
  --slippage 30 \
  --condition-orders '[{"order_type":"profit_stop","side":"sell","price_scale":"100","sell_ratio":"100"},{"order_type":"loss_stop","side":"sell","price_scale":"50","sell_ratio":"100"}]'

9. 対応チェーン

コマンド	チェーン	チェーン通貨
token / market / portfolio / track	sol / bsc / base / eth / robinhood / arc / stable	—
swap / order	sol / bsc / base / eth / robinhood / arc / stable	sol: SOL, USDC · bsc: BNB, USDC · base: ETH, USDC · eth: ETH
gas-price	sol / bsc / base / eth / robinhood / arc / stable	—
track kol / track smartmoney · market signal	sol / bsc / base / eth / robinhood / arc / stable（kol／smartmoney） · sol / bsc / robinhood / arc / stable（signal）	—
cooking create	sol / bsc / base / robinhood	—

---

10. スキルと CLI のアップグレード

# Upgrade CLI
npm install -g gmgn-cli

# Upgrade Skills
npx skills add GMGNAI/gmgn-skills

# Check current version
gmgn-cli --version

AI エージェント経由： エージェントに「gmgn-cli とスキルを最新バージョンにアップグレードして」と伝えてください。アップグレード（AI エージェント） も参照してください。

11. セキュリティと免責事項（使用前にお読みください）

このツールは、AI エージェントによって呼び出され、実際のオンチェーントランザクションを自動的に送信できます。モデルのハルシネーション、制御されていない実行、プロンプトインジェクションなど、固有のリスクを伴います。認可されると、AI エージェントは連携したウォレットアドレスに代わってトランザクションを送信します。オンチェーントランザクションは一度確定すると取り消せず、金銭的損失が発生する可能性があります。注意してご利用ください。

GMGN_PRIVATE_KEYについて

GMGN_PRIVATE_KEYは、GMGN OpenAPI サービスへの API 呼び出しを認証するために使用されるリクエスト署名キーです。ブロックチェーンウォレットの秘密鍵ではなく、オンチェーン資産を直接管理するものでもありません。漏えいした場合、攻撃者があなたになりすまして認証済み API リクエストを偽造するおそれがあります。漏えいの疑いがある場合は、GMGN ダッシュボードから直ちにキーをローテーションしてください。

ベストプラクティス

• 設定ファイルのアクセス権を制限します：chmod 600 ~/.config/gmgn/.env
• .envファイルをバージョン管理にコミットしないでください。.gitignoreに追加してください
• GMGN_API_KEYまたはGMGN_PRIVATE_KEYをログ、スクリーンショット、チャットメッセージで共有しないでください
• スワップのたびに、AI が提示する取引概要（チェーン、ウォレット、トークンアドレス、数量）を慎重に確認し、意図した内容と一致する場合にのみ確定してください
• 大きな取引を実行する前に、まず少額でテストしてください
• 常にgmgn-cliの最新バージョンを使用してください（npm install -g gmgn-cli）。現在のバージョンを確認するには、gmgn-cli --versionを実行してください

免責事項

このツールの使用、およびその出力に基づくあらゆる財務上の判断は、すべてご自身の責任で行ってください。GMGNは、モデルのハルシネーション、プロンプトインジェクション、不適切な認証情報の管理、またはユーザーの確認ミスに起因する取引損失、エラー、不正アクセスについて責任を負いません。このツールを使用することで、上記のリスクを十分に理解し、すべての責任を自発的に引き受けることに同意したものとみなされます。

npm パッケージは、各リリースを特定の git コミットおよび CI パイプラインの実行に紐付ける、プロベナンス証明付きで公開されています。次のコマンドで検証してください：

npm audit signatures gmgn-cli