birdeye-api

Birdeye API — Solana の市場データ

Birdeye は Solana のすべての DEX（およびその他 13 のチェーン）の市場データを集約しています。価格、OHLCV ローソク足、取引履歴、トークンのメタデータ、セキュリティ情報、ウォレット分析を提供します。Solana トークンの調査や過去データの分析における主要なデータソースです。

注：リアルタイム取引システムには、Yellowstone gRPC を使用してください（yellowstone-grpc スキルを参照）。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
}

長期間の履歴データのページネーション：1 リクエストあたりのローソク足は最大 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

トークン概要

包括的なメタデータと市場データを 1 回の呼び出しで取得します。

# 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

流動性が 10 ドル以上で、約 3 日以内に上場したトークンを返します。PumpFun のトークンも含めるには、meme_platform_enabled=true を設定してください。

トレンドトークン

# 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

ウォレットエンドポイント

レート制限：プランにかかわらず、すべてのウォレットエンドポイントを合わせて 1 分あたり 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": {}}

1 接続あたり最大 100 トークンです。チャネル：SUBSCRIBE_PRICE、SUBSCRIBE_TXS、SUBSCRIBE_TOKEN_NEW_LISTING、SUBSCRIBE_NEW_PAIR、SUBSCRIBE_LARGE_TRADE_TXS、SUBSCRIBE_WALLET_TXS、SUBSCRIBE_TOKEN_STATS。

料金と CU 予算

プラン	月額料金	CU	レート制限
無料	$0	30K	1 rps
Lite	$39	1.5M	15 rps
Starter	$99	5M	15 rps
Premium	$199	15M	50 rps
Premium Plus	$250	20M	50 rps + WebSocket
Business	$499-$2,300	50M-500M	100-150 rps

CU の計画：無料プラン（30K CU）では、月あたり価格の呼び出し約 750 回、または OHLCV の呼び出し約 375 回が可能です。これに合わせて予算を立ててください。

ファイル

リファレンス

• 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 — 概要、セキュリティ、トレーダーのデータを使用してトークンをスクリーニングします