Agent skill for the Elfa AI
Overview
Real-time crypto social intelligence and automated condition-engine skills for AI agents. Track trending tokens, surface narratives, search mentions, read events, positions and rankings across crypto and equities, run market analysis, and build automated trigger-based workflows. Works with , , , , , and any tool that supports the Agent Skills standard. Installs the skill via the Skills CLI; works with Claude Code, Cursor, Windsurf, Codex, and 40+ other agents. Add --global to install for all projects. Run npx skills update to refresh. For any agent that supports the Agent Skills standard: If your agent doesn't yet scan .agents/skills/, copy into its native skills directory: Cursor doesn't read SKILL.md directly; wrap each skill in an always-on rule: 1. Start a conversation in Claude Desktop 2. Attach the relevant skills/ /SKILL.md as a file 3. Ask Claude to use the skill For a bundled .skill package with API docs and scripts included (currently elfa-ai only), run .
README
Elfa AI Skills
Real-time crypto social intelligence and automated condition-engine skills for AI agents. Track trending tokens, surface narratives, search mentions, read events, positions and rankings across crypto and equities, run market analysis, and build automated trigger-based workflows.
Works with Claude Code, OpenCode, Cursor, GitHub Copilot, Codex, and any tool that supports the Agent Skills standard.
Installation
Quick (any agent)
npx skills add elfa-ai/skills
Installs the skill via the Skills CLI; works with Claude Code, Cursor, Windsurf, Codex, and 40+ other agents. Add --global to install for all projects. Run npx skills update to refresh.
Manual (spec-compliant .agents/skills/)
For any agent that supports the Agent Skills standard:
git clone https://github.com/elfa-ai/skills elfa-skills
cd elfa-skills
# Project-level (current directory only)
mkdir -p .agents/skills && cp -r skills/. .agents/skills/
# OR user-level (all projects)
mkdir -p ~/.agents/skills && cp -r skills/. ~/.agents/skills/
Manual (agent-specific paths)
If your agent doesn’t yet scan .agents/skills/, copy into its native skills directory:
| Agent | Project-level | User-level |
|---|---|---|
| Spec-compliant | .agents/skills/ |
~/.agents/skills/ |
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| OpenCode | .opencode/skills/ |
~/.config/opencode/skills/ |
# Example: install all skills into Claude Code globally
mkdir -p ~/.claude/skills && cp -r skills/. ~/.claude/skills/
Skills
| Skill | Description |
|---|---|
| elfa-ai | Crypto social intelligence + Auto condition engine — trending tokens, mentions, narratives, API v3 events, positions and rankings, AI market analysis, and automated trigger workflows |
Spec validation
Every skill in this repo follows the Agent Skills directory format: SKILL.md at the skill root, optional scripts/, references/, and assets/ resources, and spec-compatible frontmatter.
Validate a skill before publishing changes:
uvx --from skills-ref agentskills validate ./skills/elfa-ai
Get an API key
Register at https://go.elfa.ai/claude-skills and start on pay-as-you-go — $0.0145 per credit, $20 minimum top-up, card or USDC. The free tier is being phased out, so new integrations should start on PAYG.
Set the key as an environment variable:
export ELFA_API_KEY=your_key_here
Trending narratives and AI chat require Grow+ or PAYG; streaming AI chat requires PAYG or Enterprise; API v3 requires PAYG, Grow or Enterprise — see the link above for details.
Alternatively, use x402 keyless payments to pay per request with USDC on Base, Arbitrum, Polygon, Avalanche, or Solana (no signup required). See the x402 docs for setup.
Example prompts
Show me the top trending tokens in the last 24 hours
What are the top mentions for $SOL this week?
Get smart stats for @elaborateelf on Twitter
What happened to ETH in the last day, and who is long or short it right now?
Give me a curl example for the keyword mentions endpoint
Help me integrate the Elfa trending tokens endpoint in TypeScript
Alert me when BTC crosses above 100k
Set up a recurring 4h portfolio check on BTC, ETH, and SOL
Create an Auto query that triggers when ETH RSI drops below 30 on the 1h chart
Help me build a multi-condition trigger for BTC + ETH breakout confirmation
Notify me when 3+ of the funds I track all start following the same X account
Ping me every time @3PeaksTrading opens a long
Alert me when SOL turns hot on 4h mindshare
API endpoints
| Endpoint | Description |
|---|---|
/v2/aggregations/trending-tokens |
Trending tokens by mention count |
/v2/account/smart-stats |
Smart follower & engagement stats (legacy — will be removed 28 Oct 2026) |
/v2/data/top-mentions |
Top mentions for a ticker symbol |
/v2/data/keyword-mentions |
Search mentions by keyword |
/v2/data/event-summary |
AI event summaries (5 credits) |
/v2/data/trending-narratives |
Trending narrative clusters (5 credits) |
/v2/data/token-news |
Token-related news — X posts from accounts tagged as news sources |
/v2/aggregations/trending-cas/twitter |
Trending contract addresses (Twitter) |
/v2/aggregations/trending-cas/telegram |
Trending contract addresses (Telegram) |
/v2/chat |
AI chat — market analysis, token intros, account reviews |
/v2/chat/stream |
AI chat as an incremental SSE stream (PAYG / Enterprise) |
/v2/key-status |
API key usage & limits (free) |
/v2/ping |
Health check — no auth required (free) |
API v3 endpoints
API key only. Free on the Pay-as-you-go and Grow plans until 31 October 2026, and open to Enterprise keys; a Free key can call only /v3/key-status. Times are unix seconds.
| Endpoint | Description |
|---|---|
/v3/entities |
Resolve a ticker, name, handle, address, CoinGecko id, FIGI or CIK to the id every other v3 endpoint takes |
/v3/events |
Events: what happened, what it names, how prices reacted. Searchable by topic |
/v3/events/storylines |
One development followed over days |
/v3/events/arcs |
Storylines grouped into a larger movement |
/v3/market/crypto/mindshare, /v3/market/equity/mindshare |
Assets ranked by share of attention, with hot |
/v3/market/crypto/trending-contracts |
Contract addresses ranked by how many posts pasted them |
/v3/market/crypto/call-book, /v3/market/equity/call-book |
The whole market’s long/short lean, hour by hour |
/v3/calls |
Every post that takes or changes a position |
/v3/calls/episodes |
Each position from open to close, with prices and the author’s track record |
/v3/calls/positioning |
Open longs and shorts on one asset, now |
/v3/people/accounts |
Accounts ranked by standing, or by track record (metric=alphaScore, hitRate, avgReturn) |
/v3/key-status |
Plan, credits, limits and how far back the key reads |
See API v3 docs.
Auto endpoints (Condition Engine)
| Endpoint | Description |
|---|---|
/v2/auto/chat |
Builder Chat — AI-assisted query building |
/v2/auto/queries/validate |
Validate EQL query and preview cost |
/v2/auto/queries |
Create and list Auto queries |
/v2/auto/queries/:queryId |
Poll query status (GET) |
/v2/auto/queries/:queryId/cancel |
Cancel an active query (POST) |
/v2/auto/queries/:queryId |
Delete a terminal query (DELETE — triggered / expired / cancelled / failed only) |
/v2/auto/queries/stream |
Stream notifications for all your queries on one connection (SSE, API-key only) |
/v2/auto/queries/:queryId/stream |
Stream notifications for a single query via SSE |
/v2/auto/queries/:queryId/sessions |
List/get LLM analysis sessions |
/v2/auto/queries/drafts |
Upsert, list, validate, convert, delete query drafts |
/v2/auto/executions |
List and get trigger execution records |
/v2/auto/validate-symbol/:exchange/:symbol |
Check whether a symbol is supported on a venue — pre-flight for price/ta data sources |
API key mode authenticates every /v2/auto/* route with x-elfa-api-key alone. x402 mode uses x-elfa-agent-secret on query lifecycle routes instead. See Auto docs.
Full details at docs.elfa.ai.
Powered by Elfa AI · Documentation · Auto Docs
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add elfa-ai/skills