> ## Documentation Index
> Fetch the complete documentation index at: https://data.birdeye.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask a trader question. Install the right skill

> Focused, read-only workflows that turn natural-language research questions into structured Birdeye Data results.

> [card] [Browse all skills](https://birdeye.so/data-api/skills)
>
> See every skill with its capabilities, example prompts, limitations, and a sample output.

> [card] [View on GitHub](https://github.com/birdeye-so/birdeye_cli/tree/main/skills)
>
> Browse the source of every skill in the Birdeye CLI repository.

## Install Birdeye Data Skills

Before you start, make sure you have:

* Node.js 22.16 or later, with npm. Check with `node --version`.
* macOS or Linux. On Windows, use WSL.
* An agent that can run terminal commands, such as Claude Code, Codex or Cursor. Chat-only web apps cannot run skills.
* An API key from the [Birdeye Data dashboard](https://data.birdeye.so/user/auth/sign-in).

**1. Install the CLI**

Skills run through `birdeye-cli`, so install it first.

```bash theme={null}
git clone <https://github.com/birdeye-so/birdeye_cli.git>
cd birdeye_cli
npm ci && npm pack
npm install --global ./birdeye-cli-0.4.0.tgz
birdeye-cli --version
```

The last command should print `0.4.0`. If `npm pack` prints a different file name, install that file instead.

**2. Add your API key**

```bash theme={null}
birdeye-cli config init
birdeye-cli doctor --short
```

Paste the key into the hidden prompt. `doctor` should show `birdeyeConfigured: true`. Never paste your key into agent chat.

If you already exported `BIRDEYE_API_KEY` from the Skills Hub quick setup, the CLI reads it first, and you can skip `config init`.

**3. Install skills into your agent**

```bash theme={null}
npx skills add <https://github.com/birdeye-so/birdeye_cli/tree/main/skills> --skill skill-trending-list --global --agent claude-code
```

* Use `-agent codex` for Codex or `-agent cursor` for Cursor.
* List more skill names after `-skill` to install several at once.
* Reopen your agent session afterward.

**4. Verify the setup (free, 0 CU)**

Send this to your agent:

```text theme={null}
Use skill-trending-list. Run:
birdeye-cli case skill-trending-list --estimate-cu --short
Summarize the planned requests and CU. Do not fetch live data.
```

Setup works if the agent returns a CU estimate: 50 CU for this skill.

**5. Run safely**

```bash theme={null}
birdeye-cli case skill-trending-list --estimate-cu --short
birdeye-cli case skill-trending-list --max-cu 100 --short
```

The first command previews the cost for free. The second runs live and stops at 100 CU. Token and wallet skills also need `--address <ADDRESS>`.

Or ask your agent naturally and give it a CU budget.

> [!TIP]
>
> Set --max-cu at or above the estimate. A run whose estimate is higher than the cap fetches no data.

### Troubleshooting

| Symptom | Fix |
| :- | :- |
| `birdeye-cli: command not found` | Complete step 1, then restart the agent. |
| The agent doesn't see the skill | Check the `--agent` target and reopen the session. |
| `EBADENGINE` or `node:sqlite` missing | Upgrade Node.js to 22.16 or later. |
| GitHub authentication error | Use Git credentials with access to the repository. |
| The estimate works, but the live run fails | Check your API key and endpoint access. |
| A live run returns no data | Raise `--max-cu` to at least the estimate. |

## Skills Market

Choose the trader job you need. Every card opens the skill page with its capabilities, example prompts, limitations, and a sample output.

> [tab] Market Discovery
>
> > [card] [💹 Price Surge Screen](https://birdeye.so/data-api/skills/skill-price-surge)
> >
> > Find tokens surging within a market-cap band on Solana, BSC, Base, Ethereum, or Robinhood, with the reason for every excluded row.
>
> > [card] [🚀 Token Launchpad Trending](https://birdeye.so/data-api/skills/skill-launchpad-trending)
> >
> > Scan Pump.fun, Moonshot, Raydium LaunchLab, and Meteora DBC tokens by launch stage or bonding-curve progress.
>
> > [card] [🔥 Token Trending](https://birdeye.so/data-api/skills/skill-trending-list)
> >
> > Rank trending Solana tokens by trending rank, volume, or liquidity over 1h to 24h, with price, market cap, FDV, and liquidity.
>
> > [card] [🧠 Smart Wallets](https://birdeye.so/data-api/skills/skill-smart-wallets)
> >
> > Discover smart-money wallets from the top traders of Birdeye's smart-money tokens, as a deduplicated shortlist.

> [tab] Token Due Diligence
>
> > [card] [🛡️ Token Security Check](https://birdeye.so/data-api/skills/skill-token-security)
> >
> > Check a Solana token's mint and freeze authority, mutable metadata, transfer fees, and creator holdings.
>
> > [card] [📊 Token Stats](https://birdeye.so/data-api/skills/skill-token-stats)
> >
> > Get price, market cap, FDV, supply, liquidity, holders, and trading activity from 1m to 24h in one run.
>
> > [card] [🐋 Top Holder Analysis](https://birdeye.so/data-api/skills/skill-top-holder-analysis)
> >
> > Break down top holders by share of supply and group them by dev, sniper, bundler, and insider.
>
> > [card] [🏅 Top Trader Analysis](https://birdeye.so/data-api/skills/skill-top-trader-analysis)
> >
> > List up to 10 top traders of a Solana token with buy/sell volume, PnL, and wallet tags.
>
> > [card] [💧 Liquidity Pool Analysis](https://birdeye.so/data-api/skills/skill-lp-analysis)
> >
> > Show a token's top pools with venue, liquidity, 24h volume and age, plus total and exit liquidity over time.
>
> > [card] [🧪 Token Due Diligence Score](https://birdeye.so/data-api/skills/skill-token-dd-score)
> >
> > Score a Solana token 0–100 with an A+ to F rating across security, holders, activity, liquidity, and smart money, with the reason behind every deduction.
>
> > [card] [📝 Contract Due Diligence](https://birdeye.so/data-api/skills/skill-contract-dd)
> >
> > Review a Solana token's contract controls, top-holder concentration, and price behavior together.
>
> > [card] [🚨 RugCheck Audit](https://birdeye.so/data-api/skills/skill-rugcheck-audit)
> >
> > Review contract controls, holder concentration, labeled holder groups, and liquidity history, with every unverified check listed.
>
> > [card] [📈 Token Kline Pattern](https://birdeye.so/data-api/skills/skill-kline-pattern)
> >
> > Read a token's candles, detect one of 11 price patterns, score it 0–100 and mark observed support and resistance.

> [tab] Wallet & Smart Money
>
> > [card] [👀 Smart Money Holder Analysis](https://birdeye.so/data-api/skills/skill-smart-money-holders)
> >
> > See which smart traders hold a token, their share, PnL, and buy/sell activity.
>
> > [card] [📡 KOL Buy/Sell Signal](https://birdeye.so/data-api/skills/skill-kol-signal)
> >
> > Summarize KOL buying and selling on a token with buy and sell USD, net flow, and a dominance label.
>
> > [card] [🎯 Wallet Score](https://birdeye.so/data-api/skills/skill-wallet-score)
> >
> > Score a Solana wallet 0–100 on profitability, consistency, trade quality, and activity, with the breakdown behind each part.
>
> > [card] [🧭 Wallet Style](https://birdeye.so/data-api/skills/skill-wallet-style)
> >
> > Label a wallet's trading style from trade frequency and PnL, with the numbers behind the label.
>
> > [card] [💵 Wallet Analysis](https://birdeye.so/data-api/skills/skill-wallet-analysis)
> >
> > See holdings, realized and unrealized PnL, win rate, and per-token PnL from 24h to all time, plus the wallet that first funded it.
>
> > [card] [👤 Smart Money Profile](https://birdeye.so/data-api/skills/skill-smart-money-profile)
> >
> > Profile one wallet with 7-day and 30-day PnL, win rate, positions, and holdings.
>
> > [card] [🏁 Smart Money Leaderboard](https://birdeye.so/data-api/skills/skill-smart-money-leaderboard)
> >
> > Rank up to 10 wallets side by side on 7-day and 30-day PnL and win rate.

## Choose how your agent connects

Select the integration mode that fits your infrastructure.

> [card] [Birdeye Data Skills](https://birdeye.so/data-api/skills)
>
> Install question-specific workflows backed by Birdeye CLI and read-only data paths.

> [card] [MCP](https://data.birdeye.so/docs/agents/birdeye-mcp.md)
>
> Connect Birdeye Data tools directly to MCP-compatible agents and development environments.

> [card] [Direct API](https://data.birdeye.so/docs/getting-started.md)
>
> Connect your agent or application directly to Birdeye Data APIs using your own API key.

## Ask naturally

Examples of natural language queries your agent can execute.

> [card] Find opportunities
>
> Find Solana tokens up the most in the last hour with a market cap between \$50K and \$5M.

> [card] Research a token
>
> Run a due diligence score on this token and explain every deduction.

> [card] Understand a wallet
>
> How strong is this wallet as a trader, and what is its trading style?

> [card] Follow smart money
>
> Are smart traders and KOLs buying or selling this token?

> [card] [Give your agent a reliable path to on-chain data.](https://birdeye.so/data-api/skills)
>
> Start from a trader question, install the narrowest matching skill, and check the CU estimate before every run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.