脚本用法
这是一个脚本模式技能——请阅读本文件，然后在 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 链（以太坊、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') | 全面代币数据：价格、市值、完全稀释估值、供应量、持有者、流动性、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：最活跃的交易，最适合迷因币
- 以太坊：蓝筹代币、DeFi 协议
- Arbitrum/Base：L2 交易、低费用 DeFi
- 使用代币/钱包所在的原生链
解读指南
安全评分
| 分数 | 风险等级 | 操作 |
|---|---|---|
| 90-100 | 极低 | 可安全交易，合约已验证 |
| 70-89 | 低 | 一般安全，标准风险 |
| 50-69 | 中 | 谨慎操作，检查问题列表 |
| 30-49 | 高 | 高风险——仔细调查问题 |
| 0-29 | 极高 | 可能是拉地毯或诈骗——避免 |
常见危险信号：
- 铸币权限未放弃（拥有者可增发代币）
- 冻结权限已启用（拥有者可冻结交易）
- 流动性低（< 1万美元 = 高拉地毯风险）
- 集中持有（前10名持有者 > 80% 供应量）
- 无社交链接或网站
代币概览指标
价格与市值：当前估值和交易价格 交易量：交易活动反映流动性和关注度 流动性：可用于交易的流动性（越高 = 退出越安全） 价格变化百分比：1小时/24小时/7天价格变动
解读流动性：
- < 1万美元：极高风险，容易被操纵
- 1万 - 10万美元：中等风险，注意大额退出
- 10万 - 100万美元：适合中小额交易的流动性
-
100万美元：流动性强，大额仓位更安全
钱包净资产
总美元价值：按当前价格计算的所有代币持有量总和 代币细分：单个持有量及其余额和美元价值 投资组合集中度：钱包的分散程度如何？
投资组合健康指标：
- 高集中度（>80% 在同一代币中）= 高风险
- 均衡持有 = 更好的风险管理
- 大量未实现收益 = 可能有获利了结的压力
常见工作流
代币尽职调查
- birdeye_token_security — 安全评分和风险检查
- birdeye_token_overview — 价格、交易量、市值、流动性
危险信号：低安全评分（<50）+ 低流动性（<1万美元）= 拉地毯风险
示例：
用户："这个代币安全吗？[Solana 地址]"
1. 检查 birdeye_token_security → 得分 85（低风险）
2. 检查 birdeye_token_overview → 50万美元流动性，200万美元交易量
3. 结果：总体安全，流动性良好，适合交易
钱包分析
- birdeye_wallet_networth — 当前投资组合价值和细分
使用场景：
- 追踪你自己的投资组合价值
- 分析鲸鱼钱包
- 监控竞争对手持仓
示例：
用户："这个钱包里有什么？[地址]"
1. 检查 birdeye_wallet_networth → 总价值 4.5万美元
2. 细分：60% SOL、25% USDC、15% 迷因币
3. 结果：均衡的 Solana 投资组合，配有稳定币对冲
快速代币检查
用于交易前快速验证代币：
birdeye_token_overview → 一键获取价格、流动性、交易量
如果流动性 < 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）
返回：
- 总美元价值
- 代币持有量细分：
- 代币符号、名称
- 余额
- 当前价格
- 美元价值
- 投资组合百分比
示例：
birdeye_wallet_networth(
wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
chain="solana"
)
注意：钱包 API 有速率限制（5 请求/秒，75 请求/分钟）。请间隔请求。
链特定说明
Solana：
- Birdeye 支持最好的链
- 代币地址是 base58 编码的
- 最流动的交易在 Raydium、Orca 上
- 用于迷因币分析和投资组合追踪
以太坊：
- 蓝筹代币和 DeFi 协议
- 代币地址为 0x... 格式
- 更高的 Gas 费用 = 更少的微交易
Arbitrum/Base：
- 费用更低的 L2 扩展解决方案
- 不断增长的 DeFi 生态系统
- 适用于 L2 原生项目
与其他技能的集成
与 CoinGecko 互补：
- 使用 Birdeye 进行：安全检查、Solana 代币、钱包分析
- 使用 CoinGecko 进行：广泛的市场数据、历史价格、市值排名
不要重复：每项服务都有其独特优势。使用 Birdeye 获取其专业数据（安全性、Solana 聚焦、钱包追踪）。
说明
- 需要 API 密钥：设置
BIRDEYE_API_KEY环境变量 - 速率限制：钱包端点的限制为 5 请求/秒、75 请求/分钟
- 多链：对于非 Solana 查询，请始终指定
chain参数 - 安全评分：自动分析——对于高价值交易，请手动验证
- 实时数据：价格和数据频繁更新，适合活跃的交易决策
局限性
- 无热门代币：使用 CoinGecko 获取热门/顶级代币列表
- 无持有者分布：无法检查谁持有代币
- 无交易历史：无法查看近期交易
- 无聪明钱信号：使用其他来源进行鲸鱼追踪
- 有限的钱包工具：仅支持净资产（无盈亏、持仓明细或转账）
专注于可用的 3 个工具，用于安全检查、代币概览和钱包估值。