Birdeye Real-Time DeFi Data
A complete Birdeye API playbook so Claude fetches token prices, OHLCV, holders, wallet P&L and whale streams correctly across Solana and 15 other chains.
Web & APIIntermediate★ 128⑂ 79AI score 8/10Last updated: Jul 31, 2026
What it does
Turns Claude into a reliable Birdeye API caller.
- Intent-to-endpoint table: maps requests like "price", "chart", "trending", "rug check", "wallet P&L" straight to the right REST path and required params.
- Two auth modes: standard
BIRDEYE_API_KEYheaders, or x402 pay-per-request with USDC when the agent has a Solana wallet but no key. - Real-world gotchas: response fields are snake_case (
total_value,amount,value), some are strings needingNumber(), and/v1/wallet/tx_listreturns ISOblockTime(not unix) keyed by chain. - Rate limits & errors: per-tier rps, the 30 rpm Wallet API cap, and an exponential backoff recipe for 429s, plus causes/fixes for 400/401/403/404.
- Bundled assets: a production TypeScript client template, 20+ runnable examples, and reference docs for pagination, networks, and WebSocket.
Who it's for
- Solana trading bot and AI-agent developers
- Builders of token dashboards and portfolio trackers
- Researchers automating meme-coin screening and rug-risk checks
- (Note) Of little value outside crypto/DeFi work
Examples
- Token fundamentals — "What's the market cap and liquidity of this token?" →
/defi/token_overview, readingv24hUSDrather than the nonexistentvolume24h. - Safety check — "Is this token safe?" →
/defi/token_security, flagging creator share >20%, freeze authority, and top-10 holder concentration. - Wallet portfolio — "Show portfolio for wallet X" →
/wallet/v2/current-net-worthwith correct string coercion and per-token weighting. - Whale alerts — Business-tier WebSocket
SUBSCRIBE_LARGE_TRADE_TXSfor live large-trade notifications.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/sendaifun/skills/HEAD/skills/birdeye/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/birdeye folder from the GitHub repo sendaifun/skills into my ~/.claude/skills/birdeye/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/sendaifun/skills.git /tmp/sendai-skills && mkdir -p ~/.claude/skills && cp -r /tmp/sendai-skills/skills/birdeye ~/.claude/skills/birdeye⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/sendaifun/skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r skills/skills/birdeye ~/.claude/skills/birdeye - Get an API key from bds.birdeye.so.
- Export it:
export BIRDEYE_API_KEY=your_key_here(add to~/.zshrcor~/.bashrcto persist). - Restart Claude Code and try a prompt like "Show me the 1H chart for SOL" — the skill should trigger automatically.
- To run the bundled examples directly you need Node.js:
npx tsx examples/token-data/token-overview.ts.
View source on GitHub ↗License: Apache-2.0