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 是 铸币地址（例如，SOL = So11111111111111111111111111111111111111112）。

函数	说明
birdeye_token_overview(address, chain='solana')	全面的代币数据：价格、marketCap、fdv、供应量、持有人、流动性、24 小时交易量、社交链接。返回 {data: {...}} 包装对象。
birdeye_token_security(address, chain='solana')	安全审计：所有权、铸币能力、冻结能力、主要持有人集中度、可变元数据、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 一次调用即可获取价格、交易量、市值、流动性和价格变动。

“这个钱包值多少钱？” → birdeye_wallet_networth 当前投资组合价值以及包含余额和价值的详细代币明细。

多链支持

所有工具都接受 chain 参数：

• Solana：solana（大多数查询的默认值）
• EVM：ethereum、arbitrum、base、optimism、polygon、bsc、avalanche、zksync、sui

链选择指南：

• Solana：交易最活跃，最适合 memecoin
• Ethereum：蓝筹代币、DeFi 协议
• Arbitrum/Base：L2 交易、低费用 DeFi
• 使用代币/钱包原生所在的链

解读指南

安全评分

评分	风险等级	操作建议
90-100	极低	可安全交易，合约已验证
70-89	低	通常安全，但仍有常见风险
50-69	中	谨慎操作，检查问题列表
30-49	高	风险高 — 仔细调查问题
0-29	极高	可能是 Rug Pull 或诈骗 — 应避免

常见危险信号：

• 铸币权限未放弃（所有者可以增发代币）
• 已启用冻结权限（所有者可以冻结交易）
• 流动性低（< $10k = Rug 风险高）
• 持仓集中（前 10 名持有人持有 > 80% 的供应量）
• 没有社交链接或网站

代币概览指标

价格和市值：当前估值和交易价格 交易量：交易活动可反映流动性和关注度 流动性：可用于交易的流动性（越高 = 越容易安全退出） 价格变动 %：1h/24h/7d 的价格变动

流动性的解读：

• < $10k：风险极高，容易被操纵
• $10k-$100k：风险中等，留意大额退出
• $100k-$1M：适合小额/中额交易的良好流动性

• $1M：流动性强，适合较大仓位，风险更低

钱包净值

USD 总价值：按当前价格计算的所有代币持仓总和 代币明细：各项持仓的余额和价值 投资组合集中度：钱包的多元化程度如何？

投资组合健康状况指标：

• 集中度过高（>80% 集中在一种代币）= 高风险
• 持仓均衡 = 风险管理更佳
• 未实现收益较大 = 可能适合获利了结

常见工作流

代币尽职调查

1. birdeye_token_security — 安全评分和风险检查
2. birdeye_token_overview — 价格、交易量、市值、流动性

风险信号：安全评分低（<50）且流动性低（<$10k）= 有 rug pull 风险

示例：

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 → 一次调用即可获取价格、流动性和交易量

如果流动性 < $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 上的交易流动性最高
• 适用于 memecoin 分析和投资组合跟踪

Ethereum：

• 蓝筹代币和 DeFi 协议
• 代币地址采用 0x... 格式
• Gas 费用较高，不适合频繁进行小额交易

Arbitrum/Base：

• 费用较低的 L2 扩容解决方案
• DeFi 生态系统不断发展
• 适用于原生 L2 项目

与其他技能集成

与 CoinGecko 互补：

• 使用 Birdeye 获取：安全检查、Solana 代币信息、钱包分析
• 使用 CoinGecko 获取：广泛的市场数据、历史价格、市值排名

避免重复使用：各项服务各有优势。使用 Birdeye 获取其专门提供的数据（安全信息、Solana 相关数据、钱包跟踪）。

注意事项

• 需要 API 密钥：设置 BIRDEYE_API_KEY 环境变量
• 速率限制：钱包端点限制为 5 req/s、75 req/min
• 多链查询：查询非 Solana 链时，务必指定 chain 参数
• 安全评分：自动分析结果——进行高价值交易时请手动核实
• 实时数据：价格和数据会频繁更新，适合用于活跃交易决策

限制

• 不提供热门代币：使用 CoinGecko 获取热门代币/顶级代币列表
• 不提供持有者分布：无法查询代币的持有者
• 不提供交易历史：无法查看近期交易
• 不提供聪明钱信号：使用其他来源跟踪巨鲸
• 钱包工具有限：仅提供净值（不提供 PnL、持仓详情或转账信息）

请重点使用这 3 个可用工具进行安全检查、查看代币概况和评估钱包价值。