mcpField
B
birdeye-api

birdeye-api

github.com/agiprolabs数据与数据库456450 次安装8 周前更新
代码仓库

关于 birdeye-api

birdeye-api 是用于 Solana 及其他链市场研究的 API 技能，面向代币分析和历史数据工作流。它涵盖行情、交易、代币安全与钱包分析，并提供分页 OHLCV 脚本。

主要功能

  1. 01多链代币价格与概览
  2. 02OHLCV 历史数据查询
  3. 03交易记录与交易者分析
  4. 04代币安全信息检查
  5. 05钱包持仓与交易查询
  6. 06分页获取与筛选脚本

适用场景

  1. 01回测 Solana 代币历史行情
  2. 02研究代币流动性与交易活动
  3. 03新代币交易前检查安全指标

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agiprolabs/claude-trading-skills --skill birdeye-api

安装后在 Claude Code 中输入/birdeye-api确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
birdeye_endpoints.md
error_handling.md
token_overview_fields.md
scripts/
fetch_ohlcv.py
token_screener.py

详细介绍

Birdeye API — Solana 市场数据

Birdeye 汇总了 Solana 所有 DEX（以及其他 13 条链）的市场数据，包括价格、OHLCV 蜡烛图、交易历史、代币元数据、安全信息和钱包分析，是 Solana 代币研究和历史分析的主要数据源。

注意：对于实时交易系统，请使用 Yellowstone gRPC（参见 yellowstone-grpc skill）。Birdeye 最适合用于历史数据、研究和分析工作流。

快速开始

1. 获取 API 密钥

在 birdeye.so 注册 — 免费套餐：每月 30K 计算单元，每秒 1 个请求。

export BIRDEYE_API_KEY="your-api-key"
2. 安装依赖项
uv pip install httpx pandas python-dotenv
3. 发送第一个请求
import httpx, os

API_KEY = os.environ["BIRDEYE_API_KEY"]
headers = {"X-API-KEY": API_KEY, "x-chain": "solana", "accept": "application/json"}

# Get SOL price
resp = httpx.get(
    "https://public-api.birdeye.so/defi/price",
    headers=headers,
    params={"address": "So11111111111111111111111111111111111111112"},
)
price = resp.json()["data"]["value"]
print(f"SOL: ${price}")

核心端点

所有端点均使用基础 URL https://public-api.birdeye.so，并需设置 X-API-KEY 和 x-chain 标头。

代币价格
# Single token price (10 CU)
GET /defi/price?address=TOKEN_MINT

# Multiple token prices (variable CU)
POST /defi/multi_price
Body: {"addresses": ["MINT1", "MINT2", "MINT3"]}

# Price at specific timestamp (10 CU)
GET /defi/historical_price_unix?address=TOKEN_MINT&unixtime=1700000000

# Historical price series (60 CU)
GET /defi/history_price?address=TOKEN_MINT&address_type=token&type=15m&time_from=T1&time_to=T2
OHLCV 蜡烛图

回测数据的主要端点。

# Token OHLCV (40 CU, max 1000 candles per request)
GET /defi/ohlcv?address=TOKEN_MINT&type=15m&time_from=T1&time_to=T2

时间范围：1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 8H, 12H, 1D, 3D, 1W, 1M

响应：

{
  "data": {
    "items": [
      {"o": 23.5, "h": 24.1, "l": 23.2, "c": 23.8, "v": 1234567.89, "unixTime": 1692175200, "type": "15m"}
    ]
  },
  "success": true
}

长历史数据的分页：每个请求最多返回 1000 根蜡烛图。以 15 分钟为间隔时，1000 根蜡烛图约为 10.4 天。对于更长的历史数据，请滑动 time_from/time_to 时间窗口。

# Pair OHLCV (40 CU)
GET /defi/ohlcv/pair?address=PAIR_ADDRESS&type=1H&time_from=T1&time_to=T2
代币概览

一次调用即可获取完整元数据和市场数据。

# Token overview (30 CU)
GET /defi/token_overview?address=TOKEN_MINT

返回：name、symbol、decimals、logoURI、liquidity、price、mc（市值）、supply、价格变化（30m/1h/2h/4h/6h/8h/12h/24h）、交易次数、买入/卖出交易量、独立钱包数和社交链接。

完整字段列表请参见 references/birdeye_endpoints.md。

代币安全性

交易前安全检查 — 买入任何新代币前都必不可少。

# Token security (50 CU)
GET /defi/token_security?address=TOKEN_MINT

返回：

  • creatorAddress、ownerAddress — 代币由谁控制
  • top10HolderPercent — 持仓集中风险
  • mutableMetadata — 元数据是否可以更改？
  • freezeable、freezeAuthority — 代币是否可以被冻结？
  • transferFeeEnable — 是否启用了 Token-2022 转账费用？
  • isToken2022 — 使用哪个代币程序？
  • lockInfo — LP 锁定详情

快速安全检查：

  • 可增发 = ownerAddress != null（供应量可以增加）
  • 已放弃权限 = ownerAddress == null（没有增发权限）
  • 可修改 = mutableMetadata == true
  • 可冻结 = freezeable == true
交易
# Recent trades for a token (10 CU)
GET /defi/txs/token?address=TOKEN_MINT&limit=50&tx_type=swap

# Trades by time range (15 CU)
GET /defi/txs/token/seek_by_time?address=TOKEN_MINT&after_time=UNIX_TS&limit=50
# WARNING: do NOT pass both before_time and after_time — returns 422

交易响应字段：txHash、source（DEX）、blockUnixTime、owner（交易者）、from（转出的代币）、to（收到的代币），并包含金额和价格。

头部交易者
# Top traders for a token (30 CU)
GET /defi/v2/tokens/top_traders?address=TOKEN_MINT&time_frame=24h&sort_by=volume&limit=10

返回：owner、volume、volumeBuy、volumeSell、trade、tradeBuy、tradeSell、tags（例如 "arbitrage-bot"、"sniper-bot"）。

新上架代币
# New token listings (80 CU)
GET /defi/v2/tokens/new_listing?time_to=UNIX_TS&limit=10&meme_platform_enabled=true

返回约 3 天内上架且流动性 ≥ $10 的代币。设置 meme_platform_enabled=true 可包含 PumpFun 代币。

热门代币
# Trending tokens (50 CU)
GET /defi/token_trending?sort_by=rank&sort_type=asc&limit=20
代币持有者
# Token holders (50 CU)
GET /defi/v3/token/holder?address=TOKEN_MINT
搜索
# Search tokens/markets (50 CU)
GET /defi/v3/search?keyword=bonk&chain=solana

钱包端点

速率限制：无论套餐等级如何，所有钱包端点合计限制为每分钟 30 个请求。

# Wallet portfolio (100 CU)
GET /v1/wallet/token_list?wallet=WALLET_ADDRESS

# Single token balance (5 CU)
GET /v1/wallet/token_balance?wallet=WALLET&token_address=TOKEN_MINT

# Wallet transaction history (150 CU)
GET /v1/wallet/tx_list?wallet=WALLET_ADDRESS

# Wallet net worth (100 CU)
GET /wallet/v2/current-net-worth?wallet=WALLET_ADDRESS

# Wallet PnL (variable CU)
GET /wallet/v2/pnl?wallet=WALLET_ADDRESS

WebSocket API

用于价格、交易和新上架代币的实时流式传输。需要 Premium Plus（$250/月）或更高套餐。

# Connection URL
wss://public-api.birdeye.so/socket/solana?x-api-key=YOUR_KEY

# Required headers
Origin: ws://public-api.birdeye.so
Sec-WebSocket-Protocol: echo-protocol

# Subscribe to price updates
{"type": "SUBSCRIBE_PRICE", "data": {"chartType": "1m", "address": "TOKEN", "currency": "usd"}}

# Subscribe to trades
{"type": "SUBSCRIBE_TXS", "data": {"address": "TOKEN"}}

# Subscribe to new listings
{"type": "SUBSCRIBE_TOKEN_NEW_LISTING", "data": {}}

每个连接最多支持 100 个代币。频道：SUBSCRIBE_PRICE、SUBSCRIBE_TXS、SUBSCRIBE_TOKEN_NEW_LISTING、SUBSCRIBE_NEW_PAIR、SUBSCRIBE_LARGE_TRADE_TXS、SUBSCRIBE_WALLET_TXS、SUBSCRIBE_TOKEN_STATS。

定价与 CU 预算

套餐价格/月CU速率限制
Free$030K1 rps
Lite$391.5M15 rps
Starter$995M15 rps
Premium$19915M50 rps
Premium Plus$25020M50 rps + WebSocket
Business$499-$2,30050M-500M100-150 rps

CU 规划：免费套餐（30K CU）每月约可调用 750 次价格端点，或 375 次 OHLCV 端点。请合理规划预算。

文件

参考文档
  • references/birdeye_endpoints.md — 完整端点列表，包含参数、CU 成本和响应字段
  • references/error_handling.md — 错误代码、速率限制、重试策略和 CU 优化
  • references/token_overview_fields.md — token_overview 响应的完整字段参考
脚本
  • scripts/fetch_ohlcv.py — 通过分页获取 OHLCV 蜡烛图数据，用于回测
  • scripts/token_screener.py — 使用概览、安全性和交易者数据筛选代币

评论

支持 Markdown