birdeye

スクリプトの使用方法

スクリプトモードのスキル — このファイルを読み、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 overview
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 は mint アドレスです（例: SOL = So11111111111111111111111111111111111111112）。

関数	説明
birdeye_token_overview(address, chain='solana')	包括的なトークンデータ: 価格、marketCap、fdv、供給量、保有者、流動性、24時間取引量、ソーシャルリンク。{data: {...}} ラッパーを返します。
birdeye_token_security(address, chain='solana')	セキュリティ監査: 所有権、mint 可否、凍結可否、上位保有者の集中度、可変メタデータ、rug-pull の兆候。
birdeye_wallet_networth(wallet, chain='solana')	ウォレットの純資産 + トークンの内訳。wallet = ウォレットアドレス。

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

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

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

• birdeye_token_security: セキュリティスコアと rug pull リスク分析
• birdeye_token_overview: 包括的なトークンデータ（価格、取引量、時価総額、流動性）

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

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

各ツールの使用場面

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

「このトークンの詳細をすべて教えて」 → birdeye_token_overview 価格、取引量、時価総額、流動性、価格変動を 1 回の呼び出しで取得します。

「このウォレットの価値はいくらですか？」 → 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	非常に高い	rug pull または詐欺の可能性が高い — 避けてください

よくある危険信号:

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

トークン概要の指標

価格と時価総額: 現在の評価額と取引価格 取引量: 取引活動は流動性と関心を示します 流動性: 取引に利用可能な流動性（高い = 安全に出口を確保しやすい） 価格変動率: 1時間/24時間/7日間の価格変動

流動性の解釈:

• < $10k: 非常に高いリスク、操作が容易
• $10k-$100k: 中程度のリスク、大規模な出口に注意
• $100k-$1M: 小規模/中規模の取引に十分な流動性

• $1M: 強い流動性、より大きなポジションで安全

ウォレットの純資産

合計 USD 価値: 現在価格での全トークン保有額の合計 トークン内訳: 残高と価値を持つ個別の保有資産 ポートフォリオ集中度: ウォレットはどれだけ分散されていますか?

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

• 高い集中度 (1つのトークンに80%超) = 高リスク
• バランスの取れた保有 = より優れたリスク管理
• 大きな含み益 = 利益確定の可能性

一般的なワークフロー

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

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

危険信号: 低いセキュリティスコア (50未満) + 低い流動性 (1万ドル未満) = ラグプルのリスク

例:

User: "Is this token safe? [Solana address]"
1. Check birdeye_token_security → Score 85 (Low risk)
2. Check birdeye_token_overview → $500k liquidity, $2M volume
3. Result: Generally safe, good liquidity for trading

ウォレット分析

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

ユースケース:

• 自分のポートフォリオ価値を追跡する
• クジラウォレットを分析する
• 競合の保有資産を監視する

例:

User: "What's in this wallet? [address]"
1. Check birdeye_wallet_networth → $45k total value
2. Breakdown: 60% SOL, 25% USDC, 15% memecoins
3. Result: Balanced Solana portfolio with stablecoin hedging

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

取引前にトークンをすばやく検証するには:

birdeye_token_overview → 1回の呼び出しで価格、流動性、出来高を取得

流動性が1万ドル未満、または出来高が1千ドル未満の場合 → 高リスク、慎重に進めてください

ツールの詳細

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 リクエスト/秒、75 リクエスト/分)。リクエストの間隔を空けてください。

チェーン固有の注意事項

Solana:

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

Ethereum:

• 優良トークンと DeFi プロトコル
• トークンアドレスは 0x... 形式です
• より高いガス代 = 少ないマイクロトレーディング

Arbitrum/Base:

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

他のスキルとの統合

CoinGecko との補完関係:

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

重複させない: 各サービスには独自の強みがあります。Birdeye はその専門的なデータ (セキュリティ、Solana への注力、ウォレット追跡) に使用してください。

注意事項

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

制限事項

• トレンドトークンなし: トレンド/トップトークンのリストには CoinGecko を使用してください
• 保有者分布なし: 誰がトークンを保有しているか確認できません
• 取引履歴なし: 最近の取引を確認できません
• スマートマネーシグナルなし: クジラの追跡には他のソースを使用してください
• 限られたウォレットツール: 純資産のみ利用可能です (PnL、保有詳細、送金はありません)

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