birdeye

# 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: | User intent | Endpoint | |---|---| | Token ...