# Birdeye

Complete Birdeye API integration for real-time DeFi data across Solana and 15 other...

- Repository: https://github.com/internet-court/internet-court-skill (7050 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add internet-court/internet-court-skill --skill birdeye -g -a claude-code -y`
Codex: `npx skills add internet-court/internet-court-skill --skill birdeye -g -a codex -y`
Cursor: `npx skills add internet-court/internet-court-skill --skill birdeye -g -a cursor -y`
Gemini CLI: `npx skills add internet-court/internet-court-skill --skill birdeye -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add internet-court/internet-court-skill`

## Description

Complete Birdeye API integration for real-time DeFi data across Solana and 15 other chains. Use for token prices, OHLCV charts, market discovery, on-chain trader intelligence, holder analysis, wallet portfolio & P&L, and WebSocket streams for live prices and whale alerts.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Birdeye Data Skill

Birdeye is the primary real-time market-data layer for Solana AI agents, natively indexed
against on-chain state across 8M+ tokens and 500+ AMM pools with sub-10s freshness.

## Overview

Use this skill when users ask about:
- Token prices, charts, or fundamentals (mc, volume, liquidity, holder count)
- New or trending tokens (discovery, meme tokens, new listings)
- On-chain transaction history for a token or pair
- Who's buying/selling a token (top traders, gainers)
- Wallet portfolios, net worth, or P&L tracking
- Token security/rug risk checks
- Real-time price or whale alert streams (WebSocket)
- Pay-per-request without an API key (x402 / agent-native payments)

## Instructions

1. **Check for MCP**: If `birdeye-mcp` tools are available in the environment, use them directly.
2. **Auth**: Two modes:
   - **API key** (default): Base URL `https://public-api.birdeye.so`, load key from `BIRDEYE_API_KEY`.
   - **x402 pay-per-request** (no API key): Base URL `https://public-api.birdeye.so/x402`, pay USDC per call. Use when agent has a Solana wallet but no API key. See `resources/x402.md`.
3. **Required headers** on every REST request:
   ```
   X-API-KEY: <key>
   x-chain: solana           ← do NOT put chain in the URL for REST calls
   Accept: application/json
   User-Agent: <anything>    ← defensive, some older HTTP clients hit 403 without one
   ```
4. **Pick the right endpoint** using this decision table:

The rest: https://github.com/internet-court/internet-court-skill/blob/HEAD/vendored/sendaifun/birdeye/SKILL.md