Skills

Birdeye

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

Install

npx skills add internet-court/internet-court-skill --skill birdeye -g -a claude-code -y
Category
Engineering
Updated
9d ago
License
See repository
Context cost
Mediumabout 3,000 tokens
Runs scripts
Yes, review before use

What it does

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.

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:
Read the whole SKILL.md on GitHub

More in Engineering