Bitget Wallet Skill

Bitget Wallet スキル

概要

Bitget Wallet APIをラップし、自然言語によるオンチェーンデータの照会とスワップ操作を可能にする AI エージェント向けスキルです。

設計原則

原則	説明
ドメイン知識 + ツール	API ラッパーにとどまりません。スワップの流れ（docs/swap.mdを参照）、署名ガイド、セキュリティモデル、既知の落とし穴も含み、エージェントが十分な情報に基づいて判断できるようにします
外部依存関係ゼロ	コードはすべて自己完結しています。Solana の署名処理は純粋な Python で実装されています（Ed25519 + base58 を組み込み）。EVM の署名処理には標準の eth_account を使用します。API 呼び出しに必要なのは requests のみです。Solana では pip install は不要です
再実装ではなく API インフラストラクチャ	機能は Bitget Wallet の本番 API によって提供されます。このスキルは並行した実装ではなく、知識とツールのレイヤーを提供します
デフォルトで人間が介在する設計	スワップ操作ではトランザクションデータを生成しますが、自律的に署名することはありません。資金を移動するすべての操作でユーザーの確認が必要です

マーケットツールのアーキテクチャ

マーケット側はトークンの発見と分析のみを担当し、取引、ウォレット、署名は扱いません。スキルレイヤーがスコアとルールを計算し、バックエンドは生データを提供します。

Atomic Tools (Agent orchestrates)
├── bgw_token_find      Find tokens (chain scan / search / rankings / sectors)
├── bgw_token_check     Check tokens (security / dev / anti-manipulation / signals / market)
├── bgw_token_analyze   Analyze tokens (deep: timeline / trades / holdings / smart money)
├── bgw_alpha           Alpha intelligence (gems / signals)
├── bgw_address_find    Find addresses (by pool / role / criteria)
└── bgw_address_analyze Analyze addresses (scoring / PnL / style / operations / comparison)

Smart Tools (We orchestrate)
├── bgw_combo    Smart combos (token + address permutation recipes)
└── bgw_monitor  Continuous monitoring (token signals / address activity / price alerts)

コア機能

機能	説明	例
ローンチパッドスキャナー	15種類以上のフィルターで新しいプール（pump.fun、four.meme など）をスキャンします	「pump.fun で、時価総額が 10,000 ドルを超えるローンチ中のトークンをスキャンして」
トークン検索（v3）	キーワード／コントラクトで検索し、時価総額順に並べ替えられます。リスクレベルも指定できます	「ETH 上の PEPE を時価総額順に表示して」
トークン市場情報	価格、時価総額、FDV、流動性、57 のプールペア、ナラティブ、価格変動を表示します	「Lobstar の市場情報をすべて表示して」
開発者分析	開発者アドレス、ラグ履歴、LP ロック、保有状況、移行履歴を確認します	「このトークンの開発者の履歴を確認して」
セキュリティ監査	ハニーポット／ミント／プロキシ、売買税、リスクをチェックします（EVM と Solana）	「このコントラクトは安全？」
Kライン＋スマートシグナル	KOL／スマートマネーの取引マーカーとホットレベルを含む Kラインを表示します	「このトークンのスマートマネーの動きを表示して」
取引動向	複数の時間枠における売買圧力、アドレスの品質、ウォッシュ取引を検出します	「取引状況はどんな感じ？」
トランザクション分析	フィルタリング可能なタグ付きトランザクション（スマートマネー／KOL／開発者）を表示します	「このトークンの KOL の取引を表示して」
保有者分析	上位 100 保有者の分布、損益、タグ分類（CEX／スマートマネー／KOL）を表示します	「このトークンを保有しているのは誰？」
スマートマネー分析	利益を上げているアドレスの統計と、収益上位アドレスのリストを表示します	「スマートマネーのアドレスは利益が出ている？」
トークン比較	2 つのトークンの Kラインを並べて比較します	「BONK と WIF の価格推移を比較して」
アドレス検索	実績フィルターを指定して、役割別に KOL／スマートマネーのアドレスを検索します	「Solana で勝率 80％超のスマートマネーを検索して」
ソーシャルログインウォレット	Bitget Wallet TEE を介してトランザクション／メッセージに署名します。ローカルの秘密鍵は不要です	「Bitget Wallet でこのトランザクションに署名して」
残高照会	チェーン／アドレス／トークンごとのオンチェーン残高を照会します（ネイティブトークン＋ERC-20／SPL）	「BNB の残高はいくら？」
残高＋価格	1 回の呼び出しで残高を一括取得し、USD 価格も表示します	「ポートフォリオの価値はいくら？」
トークン情報	価格、時価総額、保有者、ソーシャルリンクを表示します	「SOL の価格はいくら？」
Kラインデータ	売買の内訳を含む 1m／5m／1h／4h／1d のローソク足データを表示します	トレンド分析、買い圧力の把握
トランザクション統計	5m／1h／4h／24h の売買高とトレーダー数を表示します	活動の検出、クジラの監視
ランキング	値上がり率上位／値下がり率上位／Hotpicks（厳選されたトレンド）を表示します	市場のスキャン、アルファの発見
流動性プール	LP プール情報を表示します	スリッページの推定、流動性の深さの分析
過去のコイン	タイムスタンプで新しいトークンを検索します（ページネーション対応）	「今日ローンチしたトークンは？」
トークンリスクチェック	スワップ前に送信元／送信先トークンの安全性をチェックします（購入禁止の検出）	「このトークンは安全に購入できる？」
スワップ見積もり	同一チェーン／クロスチェーンのスワップで、複数市場の見積もりを取得します	「1 SOL に対して USDC はいくら必要？」
スワップ確認	選択した市場の最終見積もりと orderId を取得します	価格とルートを確定
スワップ注文作成	署名用の未署名トランザクションデータを生成します	ウォレット署名で取引を実行
スワップ送信	署名済みトランザクションを送信します	MEV 保護付きでブロードキャスト
注文詳細	注文のライフサイクル（処理中→成功／失敗）を追跡します	「スワップの状況を確認して」
トークン送金	オンチェーンでトークンを直接送金します（EVM＋Solana）。サーバーがブロードキャストします	「0xDeF... に 100 USDT を送って」
ガス代不要の送金	ネイティブトークンのガス代なしでトークンを送金します。ガス代は USDT／USDC 残高から支払われます	「ガス代用の ETH なしで Base 上の USDC を送って」
x402 決済	Base 上の USDC で x402 対応 API の料金を支払います	「この有料 API エンドポイントにアクセスして」

⚠️ スワップ金額は人間が読み取れる形式です — 0.1 USDT には 0.1 を渡してください。100000000000000000 ではありません。レスポンス内の toAmount も人間が読み取れる形式です。これは、ほとんどのオンチェーン API とは異なります。

✨ Order Mode — 手数料不要のスワップとクロスチェーンスワップ

スワップフローにより、ほかの AI エージェント向けスワップスキルにはない、次の 2 つの機能を利用できます。

⛽ 手数料不要のトランザクション（EIP-7702）

• ネイティブトークンの残高がゼロでもトークンをスワップできます。ETH、BNB、MATIC は不要です
• ガス代は入力トークンから自動的に差し引かれます
• エージェントは署名のみを行い、バックエンドのリレイヤーがガス代を支払い、トランザクションをブロードキャストします
• すべての EVM チェーン（Ethereum、Base、BNB Chain、Arbitrum、Polygon、Morph）に対応しています

🌉 1 ステップのクロスチェーンスワップ

• 異なるチェーン間で、単一の注文でトークンをスワップできます。手動でのブリッジは不要です
• 例：Base 上の USDC → BNB Chain 上の USDT。API 呼び出し 1 回、署名 1 回で実行できます
• 手数料不要の機能と組み合わせれば、ソースチェーンでガス代がゼロのクロスチェーンスワップが可能です

仕組み：

1. quote          → Get multi-market quotes
2. confirm        → Final quote from chosen market, get orderId
3. makeOrder      → Create unsigned transaction data
4. Sign           → Agent signs with wallet key
5. send           → Submit signed data
6. getOrderDetails → Track until success

例 — 同一チェーンでのスワップ：

# Quote: BNB USDT → USDC
python3 scripts/bitget-wallet-agent-api.py quote \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress

# Confirm with chosen market
python3 scripts/bitget-wallet-agent-api.py confirm \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress \
  --market bgwevmaggregator --protocol bgwevmaggregator_v000 \
  --slippage 0.01 --feature user_gas

💳 x402 Payments — リクエストごとの API アクセス料金

x402 は、HTTP ネイティブ決済のオープンスタンダードです。エージェントが有料 API（HTTP 402）に遭遇すると、USDC の承認に署名して再試行します。アカウントも API キーも必要ありません。

仕組み：

1. Agent requests a resource → gets HTTP 402 + payment requirements
2. Agent signs EIP-3009 TransferWithAuthorization (gasless, off-chain)
3. Agent retries with PAYMENT-SIGNATURE header
4. Service's facilitator settles on-chain → agent gets the resource

主な機能：

• 完全にガス代不要 — エージェントが支払うのは USDC のみで、ファシリテーターがガス代を負担します
• アカウント不要 — ウォレットアドレスが本人確認に使用されます
• あらゆる x402 サービスで利用可能 — Pinata IPFS、DiamondClaws DeFi data、その他100 以上

# Example: pay $0.001 for Pinata IPFS upload
python3 scripts/x402_pay.py pay \
  --url "https://402.pinata.cloud/v1/pin/private?fileSize=100" \
  --private-key <key> --method POST --data '{"fileSize": 100}' --auto

ドメイン知識、署名の詳細、テストガイドについては、docs/x402-payments.mdを参照してください。

💸 手数料不要のトークン送金

トランザクションの構築、ブロードキャスト、追跡をサーバーが処理する、オンチェーンでの直接トークン送金です。手数料不要モードに対応しており、ネイティブトークンではなくステーブルコイン残高（USDT/USDC）からガス代を支払えます。

仕組み：

transfer_make_sign_send.py / social_transfer_make_sign_send.py
  → makeTransferOrder + sign + submitTransferOrder (one shot)
  → poll getTransferOrder until SUCCESS or FAILED

主な機能：

• 手数料不要（EIP-7702 / FeePayer） — ネイティブトークンのガス代がゼロでもトークンを送金できます。ガス代は USDT/USDC 残高から差し引かれます
• マルチチェーン — ETH、BNB、Base、Arbitrum、Polygon、Morph、Solana
• サーバー側でのブロードキャスト — クライアントは署名のみを行い、ノンス管理とチェーン上での追跡はサーバーが処理します
• 明示的なフォールバック — 手数料不要モードを利用できない場合、標準送金に切り替える前に確認を求めます

# Standard EVM token transfer
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain eth --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 100

# Gasless transfer (no ETH needed for gas)
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain base --contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 50 --gasless

# Poll status
python3 scripts/bitget-wallet-agent-api.py get-transfer-order --order-id <orderId>

ドメイン知識、署名モード、手数料不要の仕組みについては、docs/transfer.mdを参照してください。

対応チェーン

Ethereum · Solana · BNB Chain · Base · Arbitrum · Tron · TON · Sui · Optimism など。

---

アーキテクチャ

Natural Language Input
    ↓
AI Agent (OpenClaw / Dify / Custom)
    ↓
bitget-wallet-agent-api.py (Python 3.9+)
    ↓  ← Token auth (no API key needed)
Bitget Agent API (copenapi.bgwapi.io)
    ↓
Structured JSON → Agent interprets → Natural language response

セキュリティを考慮した設計：

• API キーや HMAC 署名は不要です。トークンベースの認証を使用します
• スワップの calldata によりトランザクションデータを生成します。署名にはウォレットキーへの明示的なアクセスが必要です
• ウォレットキーの管理： ニーモニックはセキュアストレージに保存され、秘密鍵は署名操作ごとにオンデマンドで導出され、操作後に破棄されます（永続化されません）

---

エージェントのユースケース

1. 個人向け調査アシスタント

「この Solana ミームコインが安全か確認して、価格見積もりを出してください。」

• トークン情報、セキュリティ監査、価格を 1 回のクエリで取得できます
• 対象：個人トレーダー、調査担当者
• プラットフォーム：Telegram Bot、Discord Bot、OpenClaw

2. ポートフォリオ管理エージェント

「現在のポートフォリオの合計額はいくらですか？」

• 複数のチェーンとトークンをまとめて照会し、純資産額を計算します
• 定期的なスナップショットと K 線データで過去の推移を追跡します
• 対象：DeFi ユーザー、ファンドマネージャー
• プラットフォーム：OpenClaw cron + Telegram alerts

3. 市場監視／アラートエージェント

値上がり上位の銘柄を自動でスキャンし、異常を検出してアラートを送信します

• ランキング、取引量、セキュリティ監査を組み合わせます
• 注目トークンを発見 → セキュリティ監査を自動実行 → ハニーポットを除外 → ユーザーに通知します
• 対象：オンチェーンのアルファを狙うトレーダー
• プラットフォーム：Cron jobs、Dify workflows

4. 半自動取引エージェント

「このトークンを 1 SOL 分買ってください」

• スワップ見積もり → ルートとスリッページを表示 → ユーザーが確認 → calldata を生成 → ウォレットが署名
• 人間が介在する仕組み — エージェントが単独で署名することはできません
• 対象：AI アシスタントを活用したいアクティブトレーダー
• プラットフォーム：OpenClaw + Bitget Wallet App / hardware wallet

5. アービトラージボットのデータレイヤー

DEX の価格差を監視し、クロスチェーンのアービトラージ機会を検出します

• 複数チェーンのスワップ見積もりを比較し、スプレッドを計算
• CEX データと組み合わせて、DEX-CEX 間のスプレッドを監視
• 対象：クオンツチーム
• プラットフォーム：独自の Python スクリプト、OpenClaw サブエージェント

6. コミュニティサービスボット

グループチャットで「XX コインはいくら？」と聞かれると、ボットが自動で返信します

• 軽量なクエリに対応し、高速に応答
• セキュリティ監査機能は詐欺対策としても機能
• 対象：Telegram／Discord コミュニティ
• プラットフォーム：Telegram Bot ＋ OpenClaw スキル

7. Dify／LangChain ツールノード

Dify のワークフローや LangChain エージェントのツールとして統合できます

• bitget-wallet-agent-api.py は Dify のコードノードまたは外部 API ツールとして直接利用できます
• MCP サーバーとしてラップすれば、あらゆる MCP 対応エージェントフレームワークで利用できます
• 対象：エンタープライズ向けエージェントプラットフォームとの統合

---

クイックスタート

前提条件

1. Python 3.9+
2. requests ライブラリ（pip install requests）
3. EVM 署名を行う場合：eth-account（pip install eth-account）

API キーは不要です。Agent API は、組み込みヘッダーを使ったトークンベースの認証を使用します。

Solana の署名には、追加パッケージは不要です。純粋な Python による Ed25519 と base58 は order_sign.py に組み込まれています。

使用例

# Get SOL price
python3 scripts/bitget-wallet-agent-api.py token-price --chain sol --contract ""

# Security audit for a token
python3 scripts/bitget-wallet-agent-api.py security --chain sol --contract <contract_address>

# Swap quote (5 USDT → USDC on BNB Chain)
python3 scripts/bitget-wallet-agent-api.py quote \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress

---

対応チェーン（スワップ）

チェーン	同一チェーン	クロスチェーン	ガスレス
Ethereum	✅	✅	✅
BNB Chain	✅	✅	✅
Base	✅	✅	✅
Arbitrum	✅	✅	✅
Polygon	✅	✅	✅
Morph	✅	✅	✅
Solana	✅	✅	✅
Tron	✅	✅	✅

マーケットデータのコマンドは 32 以上のチェーンに対応しています。全一覧は docs/market-data.md をご覧ください。

今後の方向性

方向性	説明
Solana の高度なスワップ	Solana のガスレス ✅ とクロスチェーン ✅ に完全対応しました（同一チェーン間 ＋ Sol↔EVM）
オンチェーンイベントのサブスクリプション	大口取引や新規プール作成を検知する WebSocket リスナー
履歴データのキャッシュ	K 線データと価格データをローカルの SQLite に保存し、API 呼び出しを削減
マルチウォレット管理	複数アドレスの残高照会と一括見積もりに対応
リスクルールエンジン	セキュリティ監査結果とカスタムルール（ブラックリスト、最低流動性しきい値）

---

対応プラットフォーム

✅ テスト済み・検証済み

プラットフォーム	ステータス	備考
OpenClaw	✅ 合格	ネイティブのスキルに対応
Manus	✅ 合格	自動インストールして実行
Bolt.new	✅ 合格	リポジトリを自動でクローンし、すべてのコマンドを実行
Devin	✅ 合格	SKILL.md を読み込み、依存関係をインストールし、正しいデータを返却
Replit Agent	✅ 合格	Web フロントエンドを含むプロジェクト全体をセットアップ

🔧 動作するはずです（ファイルシステム＋Python＋ネットワークアクセス）

プラットフォーム	種類	使用方法
Claude Code	CLI エージェント	リポジトリをクローンし、SKILL.md をプロジェクトのコンテキストに追加します
Codex CLI	CLI エージェント	リポジトリをクローンし、AGENTS.md で参照します
Cursor	IDE エージェント	プロジェクトにクローンするか、MCP 版を使用します
Windsurf	IDE エージェント	プロジェクトにクローンするか、MCP 版を使用します
Cline	VS Code エージェント	プロジェクトのワークスペースにクローンします
Aider	CLI エージェント	スクリプトをプロジェクトに追加します
OpenHands	コーディングエージェント	ファイルシステム全体を利用できる Docker サンドボックス
SWE-agent	コーディングエージェント	サンドボックス内でシェルにアクセスします
Dify	ワークフロープラットフォーム	Code ノードまたは外部 API ツールとして使用します
Coze	エージェントプラットフォーム	プラグインまたは API ツールとしてインポートします
LangChain / CrewAI	フレームワーク	bitget-wallet-agent-api.py をツールとしてラップします

💡 互換性ルール

ファイルの読み取り＋Python の実行＋インターネットへのアクセスが可能な AI エージェントであれば、このスキルを使用できるはずです。

---

関連プロジェクト

• bitget-wallet-mcp — Claude Desktop／Cursor／Windsurf 向け MCP サーバー
• bitget-wallet-cli — ターミナルユーザー向け CLI ツール

---

セキュリティに関する注意事項

• API キーは不要です — トークンベースの認証を使用するため、管理が必要なシークレットはありません
• スワップ関数は見積もりとトランザクションデータを生成します — 署名には明示的なウォレットアクセスが必要です
• 永続的なシークレットはウォレットのニーモニックのみです。秘密鍵は操作ごとに導出され、破棄されます
• 大規模な操作にはユーザーによる明示的な確認が必要です（human-in-the-loop）
• トークンを操作する前に、必ずセキュリティ監査（security コマンド）を実行してください

セキュリティ

• Solana では外部依存関係がゼロ — order_sign.py に純粋な Python による Ed25519（RFC 8032）と base58 が組み込まれています。EVM では eth_account を使用します。馴染みのないパッケージがなく、サプライチェーンのリスクもありません。
• https://copenapi.bgwapi.io（Agent API）および x402 リソースサーバーとのみ通信し、その他の外部エンドポイントには接続しません
• eval()／exec() や動的なコード実行はありません
• スキルディレクトリ外のファイルシステムにはアクセスしません
• データの収集、テレメトリー、分析は行いません
• 機密ファイル（SSH キー、認証情報、ウォレットファイルなど）にはアクセスしません
• インストール前に、ソースをご自身で監査することをおすすめします

ライセンス

MIT