MCPInstall

birdeye-api

by agiprolabsBackend & APIs

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

Installs
447
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

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

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads birdeye-api automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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.

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

TierPrice/moCURate Limit
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 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

FAQ

What does the birdeye-api skill do?

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

How do I install birdeye-api?

Run npx skills add https://github.com/agiprolabs/claude-trading-skills --skill birdeye-api in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/birdeye-api/ (personal) or .claude/skills/birdeye-api/ (project).

Which AI agents can use birdeye-api?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is birdeye-api safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains birdeye-api?

It is published by agiprolabs in agiprolabs/claude-trading-skills. It has 447 recorded installs.

More from agiprolabs/claude-trading-skills

View all →

walk-forward-validation

agiprolabs/claude-trading-skills

Walk-forward validation framework for trading strategies and ML models with time-series-aware splits, overfit detection, and regime-aware validation

Business & Finance714 installs

risk-management

agiprolabs/claude-trading-skills

Portfolio-level risk controls, drawdown management, exposure limits, and circuit breakers for crypto trading

Business & Finance637 installs

pandas-ta

agiprolabs/claude-trading-skills

Technical analysis with 130+ indicators using pandas-ta for crypto market data

Data & Databases593 installs

position-sizing

agiprolabs/claude-trading-skills

Trade sizing methods including fixed fractional, volatility-adjusted, Kelly criterion, and liquidity-constrained sizing

Business & Finance581 installs

regime-detection

agiprolabs/claude-trading-skills

Market regime identification using volatility clustering, trend detection, and statistical methods for adaptive trading

Business & Finance578 installs

kelly-criterion

agiprolabs/claude-trading-skills

Kelly criterion optimal sizing with fractional variants, edge estimation, and practical application for crypto trading

Business & Finance534 installs

Popular backend & apis skills

View category →

find-skills

vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

OfficialBackend & APIs4.1M installs

entra-app-registration

microsoft/azure-skills

Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.

OfficialBackend & APIs566.7K installs

google-agents-cli-adk-code

google/agents-cli

This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).

Backend & APIs514.8K installs

embedded-captions

heygen-com/hyperframes

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Backend & APIs453.3K installs

entra-agent-id

microsoft/azure-skills

Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).

OfficialBackend & APIs336.6K installs

neon

neondatabase/agent-skills

Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.

Backend & APIs237.1K installs