Add birdeye-plugin with dual-mode apikey/x402 runtime

[dangquocdat97]

Plugin Submission

Plugin name: birdeye-plugin
Version: 0.1.0
Type: new-plugin

Checklist

• plugin-store lint passes locally with no errors
• I have read the Development Guide
• My plugin does NOT use reserved prefixes (okx-, official-, plugin-store-)
• LICENSE file is included
• SKILL.md has YAML frontmatter with name and description

What does this plugin do?

birdeye-plugin provides Birdeye DeFi analytics access for agents with dual execution modes: API key mode and x402 pay-per-request mode.
It supports endpoint discovery/listing and generic endpoint calls for token, market, holder, trader, and smart-money data...

Which onchainos commands does it use?

None

Security Considerations

This plugin reads credentials from environment variables:
BIRDEYE_API_KEY for API key mode
SOLANA_PRIVATE_KEY (base58) for x402 mode
In x402 mode, requests may trigger micropayments signed by the provided Solana key.
Users should use a dedicated funded wallet (USDC on Solana mainnet) and keep private keys out of source control/logs.

Testing

Validated locally with lint and runtime tests:

1. Lint:
   plugin-store lint /Users/datdq/birdeye/dev/plugin-store/skills/birdeye-plugin (pass)

2. API key mode:
   list --mode apikey
   call --endpoint search_v3 ...
   call --endpoint ohlcv_v3 ...
   call --endpoint top_traders_v2 ...

3. x402 mode (Node.js 20+):
   call --endpoint price ... (successful paid call)
   call --endpoint token_overview ...
   call --endpoint token_meme_list_v3 ...
   list --mode x402 verified x402-supported subset registry.