New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Birdeye API

by agiprolabs in agiprolabs/claude-trading-skills

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

MITAuto-check passedBusiness, Finance & HR

Install Birdeye API

skills CLI
$ npx skills add agiprolabs/claude-trading-skills --skill birdeye-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agiprolabs/claude-trading-skills birdeye-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agiprolabs/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/birdeye-api .claude/skills/birdeye-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
birdeye-api
GitHub stars
410
Token cost
~1.8k tokens
SKILL.md length
450 words
Files
6 (incl. scripts, references)
Skills in repo
68
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 3 steps: Get an API Key → Install Dependencies → First Request
  • Tasks that involve Stock and market analysis
  • SKILL.md covers Quick Start, Core Endpoints, Wallet Endpoints and WebSocket API, plus 2 more sections
  • Runs Python scripts from its folder; calls uv; reaches public-api.birdeye.so; needs BIRDEYE_API_KEY and API_KEY

What it does

Birdeye API is an agent skill from agiprolabs/claude-trading-skills. Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/birdeye_endpoints.md`, `references/error_handling.md` and `references/token_overview_fields.md`).

It sits in Business, Finance & HR, covering Stock and market analysis. It works with Solana. The repository describes itself as: 68 trading, DeFi, and quantitative finance Agent Skills. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ other tools. The licence is MIT.

When your agent uses it

  • Tasks that involve Stock and market analysis

Example prompts

  • “/birdeye-api”

Requirements

  • Python 3
  • A credential in BIRDEYE_API_KEY
  • A credential in API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Get an API Key
  2. Install Dependencies
  3. First Request

What it can do on your machine

Read from SKILL.md and the folder at commit 981e1d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • public-api.birdeye.so

    Also links to:

    • birdeye.so

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BIRDEYE_API_KEY
    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Birdeye API loads about 1.8k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 450 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from agiprolabs/claude-trading-skills at commit 981e1d7, republished under its MIT licence (© agiprolabs). 450 words, ~1,840 tokens.

Download SKILL.mdSave it as .claude/skills/birdeye-api/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
birdeye-api
description
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.

bash
export BIRDEYE_API_KEY="your-api-key"
2. Install Dependencies
bash
uv pip install httpx pandas python-dotenv
3. First Request
python
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
python
# 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.

python
# 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:

json
{
  "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.

python
# 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.

python
# 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.

python
# 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
python
# 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.

Show full SKILL.md (181 more words)Show less
Top Traders
python
# 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
python
# 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.

python
# Trending tokens (50 CU)
GET /defi/token_trending?sort_by=rank&sort_type=asc&limit=20
Token Holders
python
# Token holders (50 CU)
GET /defi/v3/token/holder?address=TOKEN_MINT
python
# 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.

python
# 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.

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

© agiprolabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/birdeye-api of agiprolabs/claude-trading-skills.

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

Open the folder on GitHubat commit 981e1d7

Compare with similar skills

Birdeye API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Birdeye API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Birdeye API this skillagiprolabs/claude-trading-skills410—~1.8kAutomated safety check: PassMIT
Emblemai Crypto Walletsickn33/agentic-awesome-skills47k2 repos~669Automated safety check: PassMIT
Binance Token InfoTermiX-official/cryptoclaw100—~767Automated safety check: PassMIT
Onchainsundial-org/awesome-openclaw-skills663—~2.2kAutomated safety check: PassNone
Alpaca CLIalpacahq/cli178—~2.6kAutomated safety check: PassApache-2.0
YfinanceSilvioBaratto/optimizer176—~4kAutomated safety check: NotesCustom licence

Similar skills

  • Emblemai Crypto Wallet

    sickn33/agentic-awesome-skills

    Crypto wallet management across 7 blockchains via EmblemAI Agent Hustle API.

    47k GitHub starsUsed in 2 repos~669 tokens
    Business, Finance & HRAuto-check passed

  • Binance Token Info

    TermiX-official/cryptoclaw

    Binance Web3 official skill — search tokens, retrieve metadata, real-time market data, and candlestick charts across BSC, Base, and Solana.

    100 GitHub stars~767 tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed

  • Onchain

    sundial-org/awesome-openclaw-skills

    CLI for crypto portfolio tracking, market data, CEX history, and transaction lookups.

    663 GitHub stars~2.2k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed

  • Alpaca CLI

    alpacahq/cli

    Install, configure, and use the Alpaca CLI - a command-line tool for the Alpaca Trading API.

    178 GitHub stars~2.6k tokensUpdated today
    Business, Finance & HRAuto-check passed

  • Yfinance

    SilvioBaratto/optimizer

    Load proactively whenever the user works with yfinance or Yahoo Finance data — pulling price history, fetching financials or analyst data, screening stocks / funds / ETFs, streaming real-time…

    176 GitHub stars~4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check: notes

  • Longbridge Intel

    helsome/folio

    Market intelligence: strategy screener, popularity rankings, top movers with news correlation, quote anomalies, index/ETF constituent stocks, morning briefings, catalyst monitoring for watchlist…

    270 GitHub starsUsed in 1 repo~1.7k tokens
    Business, Finance & HRAuto-check passed

More from agiprolabs/claude-trading-skills

All 68 skills in this repo

  • Backtrader

    agiprolabs/claude-trading-skills

    Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers, and custom indicators

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

  • Coingecko API

    agiprolabs/claude-trading-skills

    Broad crypto market data from CoinGecko covering 13,000+ tokens.

    410 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed

  • Cointegration Analysis

    agiprolabs/claude-trading-skills

    Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability analysis

    410 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

  • Copy Trading

    agiprolabs/claude-trading-skills

    Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

  • Correlation Analysis

    agiprolabs/claude-trading-skills

    Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail dependence, and regime-dependent correlation

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

  • Cost Basis Engine

    agiprolabs/claude-trading-skills

    Multi-method cost basis computation including specific identification, FIFO, LIFO, HIFO, and proportional average cost with partial sell handling

    410 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Birdeye API

What does Birdeye API do?

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity. Birdeye API is an agent skill from agiprolabs/claude-trading-skills.

When should I use Birdeye API?

Birdeye API fits situations like: tasks that involve Stock and market analysis.

How do I install Birdeye API in Claude Code?

Run `npx skills add agiprolabs/claude-trading-skills --skill birdeye-api -a claude-code`. Or copy the skill folder (skills/birdeye-api in agiprolabs/claude-trading-skills) into .claude/skills/birdeye-api in your project. Claude Code loads it when a task matches its description.

How do I install Birdeye API in Codex?

Run `npx skills add agiprolabs/claude-trading-skills --skill birdeye-api -a codex`. Or copy the skill folder (skills/birdeye-api in agiprolabs/claude-trading-skills) into .agents/skills/birdeye-api in your project. Codex loads it when a task matches its description.

Can I use Birdeye API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agiprolabs/claude-trading-skills --skill birdeye-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/birdeye-api, .gemini/skills/birdeye-api, .github/skills/birdeye-api and .opencode/skills/birdeye-api in your project.

What does Birdeye API need to run?

Going by SKILL.md and its folder, Birdeye API needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named BIRDEYE_API_KEY and API_KEY. Our summary lists: Python 3; A credential in BIRDEYE_API_KEY; A credential in API_KEY.

Does Birdeye API access the network?

SKILL.md names 2 domains. In commands or code: public-api.birdeye.so; the agent is likely to contact it when it follows the instructions. As links in the text: birdeye.so. This is read from the text; nothing was executed.

Is Birdeye API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Birdeye API use?

Birdeye API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Birdeye API use?

About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to Birdeye API?

Skills that share tags, products or a category with Birdeye API: Emblemai Crypto Wallet (sickn33/agentic-awesome-skills, 47k stars), Binance Token Info (TermiX-official/cryptoclaw, 100 stars), Onchain (sundial-org/awesome-openclaw-skills, 663 stars) and Alpaca CLI (alpacahq/cli, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Birdeye API?

agiprolabs (a GitHub user) maintains it in agiprolabs/claude-trading-skills, which has 410 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on September 3, 2026.

Source: agiprolabs/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.