💬
← Back to list
💰

birdeye-api Checked

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, an…
💰 Finance & Trading skills By agiprolabs Version v1.0.0 Added 2026-09-20 Updated 2026-09-20 Source ↗
8.6Overall rating
2Views
5Downloads
366Stars

Installation

🤖 Install via AI

Copy the prompt below and send it to your AI assistant (e.g. Claude Code) — it will follow the instructions and install automatically.

Install the "birdeye-api" skill by following the instructions at https://skill123.me/install/birdeye-api.
⌨️ Command line install

Run in your terminal — downloads and installs to ~/.claude/skills/.

curl -fsSL https://skill123.me/install/birdeye-api.sh | bash
📦 Download ZIP

Download the zip and extract it into your skills directory (e.g. ~/.claude/skills/), then restart your session.

⬇ Download v1.0.0 · 16 KB
📊 Static rating
8.6/10
Trigger
6.0
Structure
9.3
Workflow
8.0
Content
10.0
Engineering
10.0
Security
10.0

Six-dimension rubric with reviewer rationale.

View scorecard ↓
🛡 Dynamic test
—

Not live-tested yet — this skill is rated on static analysis only.

About this skill

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

Birdeye API — Solana Market Data

Birdeye aggregates market data across all Solana DEXes (and 13 other chains). Prices, OHLCV candles, trade history, token metadata, security info, and wallet analytics. Primary data source for Solana token research and historical analysis.

**Note**: For real-time trading systems, use Yellowstone gRPC (see yellowstone-grpc skill). Birdeye is best for historical data, research, and analysis workflows.

Documentation

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

Birdeye API — Solana Market Data

Birdeye aggregates market data across all Solana DEXes (and 13 other chains). Prices, OHLCV candles, trade history, token metadata, security info, and wallet analytics. Primary data source for Solana token research and historical analysis.

**Note**: For real-time trading systems, use Yellowstone gRPC (see yellowstone-grpc skill). Birdeye is best for historical data, research, and analysis workflows.

Quick Start

### 1. Get an API Key

Sign up at birdeye.so — free tier: 30K compute units/month, 1 req/sec.


export BIRDEYE_API_KEY="your-api-key"

### 2. Install Dependencies


uv pip install httpx pandas python-dotenv

### 3. First Request


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}")

Core Endpoints

All endpoints use base URL https://public-api.birdeye.so with X-API-KEY and x-chain headers.

### Token Price


# 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 Candles

The primary endpoint for backtesting data.


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

**Timeframes**: 1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 8H, 12H, 1D, 3D, 1W, 1M

Response:


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

**Pagination for long history**: Max 1000 candles per request. At 15m intervals, 1000 candles ≈ 10.4 days. Slide time_from/time_to windows for longer history.


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

### Token Overview

Comprehensive metadata + market data in one call.


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

Returns: name, symbol, decimals, logoURI, liquidity, price, mc (market cap), supply, price changes (30m/1h/2h/4h/6h/8h/12h/24h), trade counts, buy/sell volumes, unique wallets, and social links.

See references/birdeye_endpoints.md for full field listing.

View full documentation

### Token Security

Pre-trade safety check — essential before entering any new token.


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

Returns:

  • creatorAddress, ownerAddress — who controls the token
  • top10HolderPercent — concentration risk
  • mutableMetadata — can metadata be changed?
  • freezeable, freezeAuthority — can tokens be frozen?
  • transferFeeEnable — Token-2022 transfer fees?
  • isToken2022 — which token program?
  • lockInfo — LP lock details

**Quick safety checks**:

  • Mintable = ownerAddress != null (supply can increase)
  • Renounced = ownerAddress == null (no mint authority)
  • Mutable = mutableMetadata == true
  • Freezeable = freezeable == true

### Trades


# 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

Trade response fields: txHash, source (DEX), blockUnixTime, owner (trader), from (token sent), to (token received) with amounts and prices.

### Top Traders


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

Returns: owner, volume, volumeBuy, volumeSell, trade, tradeBuy, tradeSell, tags (e.g., "arbitrage-bot", "sniper-bot").

### New Listings


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

Returns tokens listed within ~3 days with liquidity ≥ $10. Set meme_platform_enabled=true to include PumpFun tokens.

### Trending Tokens


# Trending tokens (50 CU)
GET /defi/token_trending?sort_by=rank&sort_type=asc&limit=20

### Token Holders


# Token holders (50 CU)
GET /defi/v3/token/holder?address=TOKEN_MINT

### Search


# Search tokens/markets (50 CU)
GET /defi/v3/search?keyword=bonk&chain=solana

Wallet Endpoints

**Rate limited**: 30 rpm across all wallet endpoints regardless of tier.


# 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

Real-time streaming for price, trades, and new listings. Requires Premium Plus ($250/mo) or higher.


# 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": {}}

Max 100 tokens per connection. Channels: SUBSCRIBE_PRICE, SUBSCRIBE_TXS, SUBSCRIBE_TOKEN_NEW_LISTING, SUBSCRIBE_NEW_PAIR, SUBSCRIBE_LARGE_TRADE_TXS, SUBSCRIBE_WALLET_TXS, SUBSCRIBE_TOKEN_STATS.

Pricing & CU Budget

| Tier | Price/mo | CU | Rate Limit |

|------|----------|-----|-----------|

| Free | $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 planning**: Free tier (30K CU) = ~750 price calls OR ~375 OHLCV calls/month. Budget accordingly.

Files

### References

  • references/birdeye_endpoints.md — Complete endpoint listing with parameters, CU costs, and response fields
  • references/error_handling.md — Error codes, rate limits, retry strategies, CU optimization
  • references/token_overview_fields.md — Full field reference for token_overview response

### Scripts

  • scripts/fetch_ohlcv.py — Fetch OHLCV candle data with pagination for backtesting
  • scripts/token_screener.py — Screen tokens using overview, security, and trader data

Score breakdown

Trigger
6.0
Description is What-only with rich endpoint keywords; When-Not (use Yellowstone gRPC for real-time) appears only in SKILL.md body, not the description; no trigger variants, no Chinese keywords.
Structure
9.3
253-line SKILL.md; three focused references (endpoints, error_handling, token_overview_fields) + two scripts; Files table; inline pointers to references.
Workflow
8.0
Tool wrapper pattern with per-endpoint CU costs, pagination windows (1000-candle limit quantified), WebSocket subscription reference, tier/rate-limit tables, retry/backoff in scripts; no demo mode or verification step.
Content
10.0
Concise, concrete request examples with real params and response schemas; consistent formatting.
Engineering
10.0
Valid frontmatter; shebangs, env-key check with clear guidance, deps declared; all referenced paths exist.
Security
10.0
Manifest: GET to public-api.birdeye.so only (official, declared); env read BIRDEYE_API_KEY sent solely as auth header to Birdeye; no local file reads, no writes, no persistence; capabilities match declared scope. No injection, no secrets.
Solid tool-wrapper for Birdeye: endpoint docs with CU costs, pagination math, 422 gotcha warnings, pricing/CU budgeting table, dedicated error-handling reference, scripts with 429 backoff. Description lacks When-Not in frontmatter (only in body note); scripts lack --demo mode.

Assessment methodology

🧪
AI-assessed
Evaluated by automated analysis across quality, usability, and security dimensions. This is not a substitute for your own review — always inspect a skill before installing it.

Version history

v1.0.0 2026-09-20
16 KB

Imported from agiprolabs/claude-trading-skills@main

Related skills

💰 dex-execution 9.3
Solana DEX swap execution via Jupiter aggregator including quoting, transaction building, signing…
💰 coingecko-api 9.1
Broad crypto market data from CoinGecko covering 13,000+ tokens. Global market stats, historical …
💰 jito-bundles 9.1
Jito bundle submission for MEV protection on Solana — bundle building, tip strategies, block engi…
💰 kalshi-api 9.1
Kalshi exchange mechanics — RSA-PSS auth, order schema, YES/NO orderbook convention, WebSocket, a…