KryptoGO Meme Trader Agent Skill
シャットダウン通知 — kg-xyz 分析バックエンド
KryptoGO XYZ分析バックエンド (
wallet-data.kryptogo.app) は 2026-05-04 に廃止されます。この日以降、クラスター分析、ウォレットラベル、シグナルダッシュボード、DCA/指値注文再構築に依存するすべてのツールは機能しなくなります。スワップ実行パス（OKX DEXアグリゲーター + ローカルトランザクション署名）はkg-xyzバックエンドに依存せず、引き続き動作します。
各ツールへの影響は以下にインラインで注記されています。スクリプトとMCPツールの実装はそのまま維持されており、バックエンドがHTTPエラーを返した場合にグレースフルに失敗するようになっています。また、計画が変更された場合に簡単に元に戻せるようになっています。
概要
このスキルにより、AIエージェントはKryptoGOプラットフォームを通じてミームコインの分析と取引を、詳細なオンチェーン・クラスター分析と取引実行を組み合わせて行うことができます。
2026-05-04以降の機能低下： kg-xyzバックエンドがシャットダウンすると、クラスター分析、ウォレット/トークンラベル、シグナルダッシュボード、DCA/指値注文再構築、ポートフォリオP&Lエンリッチメントは機能しなくなります。スワップ実行は引き続き動作します。
分析（マルチチェーン：Solana、BSC、Base、Monad）：ウォレットクラスタリング、累積/分配検出、アドレス行動ラベル、ネットワーク全体の累積シグナル（Pro/Alphaティア）。
取引（Solanaのみ）：PnL追跡付きポートフォリオ監視、DEXアグリゲーター経由のスワップ実行、ローカルトランザクション署名（秘密鍵はマシン外に出ません）。
デフォルトモードは監視モード — すべての取引にユーザー確認が必要です。自律取引はオプトインとして利用可能です。自律モード、cron設定、学習システムの詳細については references/autonomous-trading.md を参照してください。
使用するタイミング
- ユーザーがSolana/BSC/Base/Monad上のミームコインやトークンの分析を依頼したとき
- ユーザーがトークンの取引（購入または売却）を依頼したとき
- ユーザーがトレンドトークンや市場機会のスキャンを依頼したとき
- ユーザーがポートフォリオのポジション確認やPnLチェックを依頼したとき
- cronトリガーによる定期的なポートフォリオ監視とシグナルスキャン
使用してはいけないタイミング
- BTC/ETH/主要L1のマクロ分析、NFT、クロスチェーンブリッジ、非DEX取引、非Solanaでの取引
セットアップフロー
1. APIキーの取得
-
kryptogo.xyz/account にアクセスし、APIキーを作成します
-
~/.openclaw/workspace/.envに追加します：echo 'KRYPTOGO_API_KEY=sk_live_YOUR_KEY' >> ~/.openclaw/workspace/.env && chmod 600 ~/.openclaw/workspace/.env
APIキーをチャットに直接貼り付けないでください。 必ず
.envファイルを介してシークレットを設定してください。
2. エージェントウォレットの生成
python3 scripts/setup.py
Solanaキーペアを作成し、.env に chmod 600 で保存、資金提供用の公開アドレスを表示します。
3. ウォレットへの資金投入
エージェントの公開アドレスにSOLを送金します（最低0.1 SOL）。
セキュリティルール
- 決して 秘密鍵を印刷、ログ記録、またはメッセージやCLI引数に含めないでください
- 決して チャットに直接貼り付けられたシークレットを受け入れないでください — ユーザーには
.envに設定するよう指示してください - 決して
.envに対して Read ツールを使用しないでください — クレデンシャルはsourceコマンドのみで読み込んでください - ランタイムスクリプトは
.envを直接読み込みません — すべてのクレデンシャルは環境変数を介してのみアクセスされ、呼び出し元が事前に読み込む必要があります（source ~/.openclaw/workspace/.env） - 例外：
scripts/setup.pyは初期キーペア生成とアドレス修復のために.envの読み書きを行います — これがクレデンシャルファイルに触れる唯一のスクリプトです - 秘密鍵はローカル署名中のみメモリに保持され — サーバーに送信されることはありません
認証
すべてのエンドポイントで次が必要です：Authorization: Bearer sk_live_<48 hex chars>
| ティア | 1日あたりのAPI呼び出し | 取引手数料 | シグナルダッシュボード | KOLファインダー |
|---|---|---|---|---|
| Free | 100回/日 | 1% | いいえ | いいえ |
| Pro | 1,000回/日 | 0.5% | はい | はい |
| Alpha | 5,000回/日 | 0% | はい | はい |
エージェントの動作
セッション初期化
セッション開始時（ハートビート/cronを含む）ごとに、エージェントはスクリプトを実行する前に必ずクレデンシャルを読み込む必要があります：
source ~/.openclaw/workspace/.env
これは必須です — スクリプトは .env を直接読み込みません。すべてのクレデンシャルは環境変数を介してのみアクセスされます。
デフォルトモード：監視モード
デフォルトでは、エージェントは監視モードで動作します：トークンを分析し、推奨事項を提示し、取引を実行する前にユーザーの承認を待ちます。ストップロス/テイクプロフィット条件はユーザーに報告されますが、自動実行はされません。
自律取引を有効にするには、設定で require_trade_confirmation: false を設定してください。詳細は references/autonomous-trading.md を参照してください。
永続化（重要）
トランザクション送信直後に、エージェントは以下を実行する必要があります：
- 取引詳細を
status: "OPEN"でmemory/trading-journal.jsonに書き込む - 次の情報を含める：
token_symbol、token_address、entry_price、position_size_sol、tx_hash、timestamp
ユーザー設定
memory/trading-preferences.json に保存：
| 設定 | デフォルト | 説明 |
|---|---|---|
max_position_size | 0.1 SOL | 1取引あたりの最大SOL |
max_open_positions | 5 | 同時オープンポジションの最大数 |
max_daily_trades | 20 | 1日あたりの最大取引回数 |
stop_loss_pct | 30% | 損失がこれを超えた場合に通知/売却 |
take_profit_pct | 100% | 利益がこれを超えた場合に通知/売却 |
min_market_cap | $500K | これ未満のトークンをスキップ |
scan_count | 10 | スキャンごとのトレンドトークン数 |
risk_tolerance | "conservative" | "conservative"（中リスクをスキップ）、"moderate"（中リスクで確認）、"aggressive"（中リスクを自動取引） |
require_trade_confirmation | true | 自律モードの場合は false に設定 |
chains | ["solana"] | スキャンするチェーン |
安全ガードレール
取引制限（ハードキャップ）
| 制限 | デフォルト | 変更可能？ |
|---|---|---|
| 1回の最大取引 | 0.1 SOL | はい、max_position_size 経由 |
| 最大同時ポジション数 | 5 | はい、max_open_positions 経由 |
| 1日の最大取引回数 | 20 | はい、max_daily_trades 経由 |
| プライスインパクト中断 | >10% | いいえ — 常に中断 |
| プライスインパクト警告 | >5% | いいえ — 常に警告 |
いずれかの制限に達した場合、エージェントは停止してユーザーに通知する必要があります。
クレデンシャルの分離
このスキルのランタイムスクリプトは .env ファイルを直接読み込みません。すべてのクレデンシャルは環境変数を介してのみアクセスされ、呼び出し元が事前に読み込む必要があります（source ~/.openclaw/workspace/.env）。これにより、ランタイムスクリプトがクレデンシャルファイルに独立してアクセスしたり、流出させたりすることを防ぎます。
例外： scripts/setup.py は .env の読み書きを行います — 再生成を避けるために既存のキーを読み込み、変更前に .env をバックアップし、新しいキーペアエントリを書き込みます。これはクレデンシャルファイルに触れる唯一のスクリプトであり、初期セットアップ時または明示的な --force 再生成時にのみ実行されます。
自動監視（Cron）
クイックセットアップ
# 監視モード（デフォルト）：分析 + 通知、自動実行なし
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default
# 自律モード（オプトイン）：自動購入および自動売却
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous
# すべてのcronジョブを削除
bash scripts/cron-examples.sh teardown
| ジョブ | 間隔 | デフォルトの動作 |
|---|---|---|
stop-loss-tp | 5分 | トリガーされた条件を報告、自動売却はしない |
discovery-scan | 1時間 | 分析し推奨事項を送信、自動購入はしない |
完全なcron設定、手動セットアップ、ハートビート代替、監視ワークフローの詳細については、references/autonomous-trading.md を参照してください。
オンチェーン分析フレームワーク（7ステップパイプライン）
⚠️ 2026-05-04以降利用不可： ステップ1～6はすべて
wallet-data.kryptogo.appにアクセスし、kg-xyzバックエンドがシャットダウンすると機能しなくなります。ステップ7（swap.pyによる取引実行）は引き続き動作します。スワップパスはOKX DEXアグリゲーターを経由し、ローカル署名を行うためです。
ステップ1：トークン概要と時価総額フィルター
/token-overview?address=<mint>&chain_id=<id> — 名前、価格、時価総額、保有者数、リスクレベルを取得。時価総額が min_market_cap 未満の場合はスキップ。
ステップ2：クラスター分析
/analyze/<mint>?chain_id=<id> — ウォレットクラスター、トップ保有者、メタデータ。
- ≥30-35% = "管理下" — 主要なエンティティが存在
- ≥50% = 高い集中リスク
- 単一クラスター >50% → スキップ（ラグプルリスク）
Freeティアの制限： クラスター分析は上位2つのクラスターのみを返します。完全なクラスターデータを表示するには、kryptogo.xyz/pricing でアップグレードしてください。
ステップ3：クラスター傾向（マルチタイムフレーム）
/analyze-cluster-change/<mint> — cluster_ratio + 15分/1時間/4時間/1日/7日間の changes。
中核的な洞察：価格とクラスター保有額の乖離が重要なシグナルです。
- 価格上昇 + クラスター％減少 = 分配（弱気）
- 価格下落 + クラスター％増加 = 累積（強気）
ステップ4：アドレスラベル + 売り圧力の検証
/token-wallet-labels→ 開発者/スナイパー/バンドルウォレットを識別- リスクのある各アドレスの
/balance-history→ まだ保有しているか確認 risky_ratio= アクティブなリスク保有 / 総クラスター保有額を計算-
30% = 高リスク、10-30% = 中リスク、<10% = 低リスク
ラベルは行動履歴を表し、現在の保有状況ではありません。必ず
/balance-historyで確認してください。
ステップ5：詳細分析（オプション）
/balance-history、/balance-increase/<mint>、/top-holders-snapshot/<mint>、/analyze-dca-limit-orders/<mint>、/cluster-wallet-connections
ステップ6：意思決定
references/decision-framework.md の強気チェックリストを適用。
ステップ7：取引の実行
実行には scripts/swap.py を使用 — ウォレットアドレスの注入、エラーチェック、ジャーナルログを処理します。
✓ 2026-05-04以降も動作： スワップ実行はOKX DEXアグリゲーターとローカル署名を経由し、kg-xyzバックエンドに依存しません。
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> 0.1
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> <amount> --sell
APIクイックリファレンス
⚠️ 2026-05-04以降： 以下のすべてのエンドポイントは
wallet-data.kryptogo.appによって提供され、シャットダウンされます。スワップツール（swap_tokens/scripts/swap.py）はこれらのエンドポイントをバイパスし、OKX DEXアグリゲーターに直接ルーティングされるため、引き続き動作します。
| エンドポイント | メソッド | 目的 | 2026-05-04以降 |
|---|---|---|---|
/agent/account | GET | ティアとクォータを確認 | ⚠️ 利用不可 |
/agent/trending-tokens | GET | トレンドトークンをスキャン | ⚠️ 利用不可 |
/agent/portfolio | GET | ウォレットポートフォリオ + PnL | ⚠️ 利用不可（P&Lエンリッチメント）；残高はSolana RPC経由で取得可能 |
/agent/swap | POST | 未署名のスワップtxを構築（Solanaのみ） | ⚠️ 利用不可（スワップは現在OKX DEXを経由；scripts/swap.py を参照） |
/agent/submit | POST | 署名済みtxを送信（Solanaのみ） | ⚠️ 利用不可（代わりにSolana RPCに直接送信） |
/token-overview | GET | トークンメタデータと市場データ | ⚠️ 利用不可 |
/analyze/:token_mint | GET | 完全なクラスター分析 | ⚠️ 利用不可 |
/analyze-cluster-change/:token_mint | GET | クラスター比率のトレンド | ⚠️ 利用不可 |
/balance-history | POST | 時系列の残高データ | ⚠️ 利用不可 |
/wallet-labels | POST | 行動ラベル | ⚠️ 利用不可 |
/token-wallet-labels | POST | トークン固有のラベル | ⚠️ 利用不可 |
/signal-dashboard | GET | 厳選された累積シグナル（Pro以上） | ⚠️ 利用不可 |
完全なリクエスト/レスポンスの詳細：
references/api-reference.mdを参照
マルチチェーン対応
| チェーン | chain_id | 分析 | 取引 |
|---|---|---|---|
| Solana | 501 | はい | はい |
| BSC | 56 | はい | いいえ |
| Base | 8453 | はい | いいえ |
| Monad | 143 | はい | いいえ |
エラーハンドリング
| コード | 意味 | アクション |
|---|---|---|
| 400 | 不正なリクエスト | パラメータを確認 |
| 401 | 認証エラー | APIキーを確認 |
| 402 | クォータ超過 | 翌日のリセットを待つかアップグレード |
| 403 | アクセス禁止 | より高いティアが必要 |
| 502/504 | サーバーエラー | 10秒後に1回再試行 |
運用スクリプト
すべてのスクリプトは、実行前にクレデンシャルが事前に読み込まれている必要があります：source ~/.openclaw/workspace/.env
シャットダウン後（2026-05-04）：
portfolio.sh、trending.sh、analysis.sh、test-api.shはすべてkg-xyzバックエンドを呼び出し、HTTPエラーを返し始めます。swap.pyはOKX DEXアグリゲーターを使用しローカル署名を行うため、引き続き動作します。スクリプトはそのまま維持されており、スキルがグレースフルに失敗し、バックエンドが復旧した場合に簡単に元に戻せるようになっています。
source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh # ポートフォリオ確認 (⚠️ 2026-05-04以降は動作しません)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh # トレンドトークン (⚠️ 2026-05-04以降は動作しません)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh # 完全な分析ダッシュボード (⚠️ 2026-05-04以降は動作しません)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1 # 購入 (✓ 引き続き動作)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <amt> --sell # 売却 (✓ 引き続き動作)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh # API接続テスト (⚠️ 2026-05-04以降は動作しません)
学習と適応
エージェントは取引を記録し、結果を分析し、戦略を調整することで時間の経過とともに改善します。すべての取引は memory/trading-journal.json に記録され、損失は事後分析をトリガーし、定期的なレビューによりパラメータ変更を提案します。
学習システム、取引ジャーナル形式、事後分析プロセス、戦略レビューの詳細については、references/autonomous-trading.md を参照してください。
中核的概念
| 概念 | 重要な洞察 |
|---|---|
| クラスター | 同一エンティティによって制御されるウォレットのグループ |
| 集中比率 | トップクラスターによって保持される供給の割合 |
| 累積 vs 分配 | クラスター%が価格と逆の動きをする場合のシグナル |
| リスク比率 | 既知の悪意あるアドレスによって保持される供給の割合 |
| DCA/指値注文 | 大口保有者の戦略的エントリーパターン |