Birdeye – トークン＆ウォレット分析（Solana + EVM）

スクリプトの使用法

スクリプトモードのスキルです。このファイルを読み、bash ブロックから呼び出してください：

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/birdeye")
from exports import birdeye_token_overview, birdeye_token_security, birdeye_wallet_networth

# SOL 概要
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF

exports.py で利用可能な関数：birdeye_token_security、 birdeye_token_overview、birdeye_wallet_networth。正確なシグネチャについては直接 exports.py を参照してください。

Birdeye

マルチチェーンデータプロバイダー。トークンインテリジェンスとウォレット分析を提供します。Solana + EVM チェーン（Ethereum、Arbitrum、Base など）をカバー。セキュリティ分析とポートフォリオトラッキングにおける Birdeye のユニークな機能に焦点を当てています。

関数リファレンス（シグネチャ）

すべての関数は exports.py にあります。chain のデフォルトは solana です。EVM チェーンは ethereum、bsc、polygon、arbitrum、optimism、base、avalanche、zksync、sui をサポート。Solana のトークン address はミントアドレス（例：SOL = So11111111111111111111111111111111111111112）です。

関数	説明
birdeye_token_overview(address, chain='solana')	包括的なトークンデータ：価格、時価総額、FDV、供給量、ホルダー数、流動性、24時間出来高、ソーシャルリンク。{data: {...}} ラッパー形式で返します。
birdeye_token_security(address, chain='solana')	セキュリティ監査：所有権、発行可能性、凍結可能性、トップホルダーの集中度、可変メタデータ、ラグプル指標。
birdeye_wallet_networth(wallet, chain='solana')	ウォレットの総資産価値 + トークン内訳。wallet = ウォレットアドレス。

Birdeye はキャメルケースのフィールドを使用します（marketCap、priceChange24h など）。すべてのレスポンスは {data: {...}} のエンベロープでラップされています — result.get('data', {}) で抽出してください。

利用可能なツール（3 つ）

トークンインテリジェンス（2 つのツール）

• birdeye_token_security: セキュリティスコアとラグプルリスク分析
• birdeye_token_overview: 包括的なトークンデータ（価格、出来高、時価総額、流動性）

ウォレット分析（1 つのツール）

• birdeye_wallet_networth: 現在のウォレット総資産とポートフォリオの内訳

各ツールの使用タイミング

「このトークンは安全ですか？」 → birdeye_token_security セキュリティスコア、ラグプルリスク分析、コントラクト脆弱性検出。

「このトークンの詳細を教えて」 → birdeye_token_overview 価格、出来高、時価総額、流動性、価格変動を一度に取得。

「このウォレットの価値は？」 → birdeye_wallet_networth 現在のポートフォリオ価値と、残高・価値付きの詳細なトークン内訳。

マルチチェーンサポート

すべてのツールは chain パラメータを受け入れます：

• Solana: solana（ほとんどのクエリのデフォルト）
• EVM: ethereum、arbitrum、base、optimism、polygon、bsc、avalanche、zksync、sui

チェーン選択のガイドライン：

• Solana: 最も活発な取引、ミームコインに最適
• Ethereum: ブルーチップトークン、DeFi プロトコル
• Arbitrum/Base: L2 取引、低手数料 DeFi
• トークン/ウォレットがネイティブなチェーンを使用

解釈ガイド

セキュリティスコア

スコア	リスクレベル	アクション
90-100	非常に低い	取引しても安全、検証済みコントラクト
70-89	低い	概ね安全、標準的なリスク
50-69	中程度	注意して進め、問題リストを確認
30-49	高い	高リスク — 問題を注意深く調査
0-29	非常に高い	ラグプルまたは詐欺の可能性 — 避ける

一般的なレッドフラグ：

• ミント権限が放棄されていない（所有者がトークンを発行できる）
• 凍結権限が有効（所有者が取引を凍結できる）
• 流動性が低い（< $10k = ラグプルリスクが高い）
• 保有が集中している（トップ10ホルダーで供給量の80%超）
• ソーシャルリンクやウェブサイトがない

トークン概要メトリクス

価格と時価総額：現在の評価額と取引価格 出来高：取引活動は流動性と関心を示す 流動性：取引に利用可能な流動性（高いほど安全な出口） 価格変動率（%）：1時間/24時間/7日の価格変動

流動性の解釈：

• < $10k: 非常に高いリスク、操作されやすい
• $10k-$100k: 中程度のリスク、大口の出口に注意
• $100k-$1M: 小中規模の取引に適した流動性

• $1M: 強固な流動性、大規模ポジションでも安心

ウォレット総資産

合計 USD 価値：現在の価格における全トークン保有額の合計 トークン内訳：残高と価値付きの個別保有状況 ポートフォリオ集中度：ウォレットの分散状況

ポートフォリオ健全性指標：

• 高い集中度（1トークンで80%超）＝高リスク
• バランスの取れた保有＝より良いリスク管理
• 大きな含み益＝利益確定の可能性

一般的なワークフロー

トークンのデューデリジェンス

1. birdeye_token_security — セキュリティスコアとリスクチェック
2. birdeye_token_overview — 価格、出来高、時価総額、流動性

レッドフラグ：低セキュリティスコア（<50）+ 低流動性（<$10k）= ラグプルリスク

例：

ユーザー：「このトークンは安全ですか？[Solanaアドレス]」
1. birdeye_token_security を確認 → スコア85（低リスク）
2. birdeye_token_overview を確認 → 流動性$500k、出来高$2M
3. 結果：概ね安全、取引に十分な流動性

ウォレット分析

1. birdeye_wallet_networth — 現在のポートフォリオ価値と内訳

使用例：

• 自分のポートフォリオ価値を追跡
• クジラウォレットの分析
• 競合他社の保有状況の監視

例：

ユーザー：「このウォレットには何が入っていますか？[アドレス]」
1. birdeye_wallet_networth を確認 → 合計$45k
2. 内訳：60% SOL、25% USDC、15% ミームコイン
3. 結果：ステーブルコインでヘッジされたバランスの良いSolanaポートフォリオ

クイックトークンチェック

取引前にトークンを素早く検証する場合：

birdeye_token_overview → 価格、流動性、出来高を一度に取得

流動性 < $10k または出来高 < $1k → 高リスク、注意して進める

ツール詳細

birdeye_token_security

パラメータ：

• address（必須）：トークンコントラクトアドレス
• chain（オプション）：ブロックチェーン（デフォルト：solana）

戻り値：

• セキュリティスコア（0-100）
• リスクレベル
• 検出された問題のリスト
• コントラクト分析結果

例：

 birdeye_token_security(
   address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
   chain="solana"
 )

birdeye_token_overview

パラメータ：

• address（必須）：トークンコントラクトアドレス
• chain（オプション）：ブロックチェーン（デフォルト：solana）

戻り値：

• シンボル、名前
• 現在の価格
• 24時間出来高
• 時価総額
• 流動性
• 価格変動（1時間、24時間、7日）

例：

 birdeye_token_overview(
   address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
   chain="solana"
 )

birdeye_wallet_networth

パラメータ：

• wallet（必須）：ウォレットアドレス
• chain（オプション）：ブロックチェーン（デフォルト：solana）

戻り値：

• 合計 USD 価値
• トークン保有内訳：
  • トークンシンボル、名前
  • 残高
  • 現在の価格
  • USD 価値
  • ポートフォリオ割合

例：

 birdeye_wallet_networth(
   wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
   chain="solana"
 )

注意：ウォレット API にはレート制限があります（5 req/s、75 req/min）。リクエストの間隔を空けてください。

チェーン固有の注意点

Solana：

• Birdeye で最もサポートされているチェーン
• トークンアドレスは base58 エンコード
• Raydium、Orca で最も流動性の高い取引
• ミームコイン分析とポートフォリオ追跡に使用

Ethereum：

• ブルーチップトークンと DeFi プロトコル
• トークンアドレスは 0x... 形式
• ガス代が高いため、マイクロトレードは少ない

Arbitrum/Base：

• 低手数料の L2 スケーリングソリューション
• 成長する DeFi エコシステム
• L2 ネイティブプロジェクトに最適

他のスキルとの連携

CoinGecko との補完関係：

• Birdeye を使用：セキュリティチェック、Solana トークン、ウォレット分析
• CoinGecko を使用：広範な市場データ、履歴価格、時価総額ランキング

重複しないでください：各サービスには独自の強みがあります。特殊なデータ（セキュリティ、Solana フォーカス、ウォレット追跡）には Birdeye を使用してください。

注意事項

• API キーが必要：環境変数 BIRDEYE_API_KEY を設定
• レート制限：ウォレットエンドポイントは 5 req/s、75 req/min に制限
• マルチチェーン：Solana 以外のクエリでは必ず chain パラメータを指定
• セキュリティスコア：自動分析 — 高額取引の場合は手動で検証
• リアルタイムデータ：価格とデータは頻繁に更新され、アクティブな取引判断に適しています

制限事項

• トレンドトークンはなし：トレンド/トップトークン一覧には CoinGecko を使用
• ホルダー分布なし：トークンの保有者を確認不可
• 取引履歴なし：最近の取引を確認不可
• スマートマネーシグナルなし：クジラ追跡には他のソースを使用
• 限定的なウォレットツール：ネットワースのみ利用可能（損益、保有詳細、送金の確認不可）

セキュリティチェック、トークン概要、ウォレット評価のための 3 つの利用可能なツールに焦点を当ててください。