Skip to main content

What is Elfa

Elfa is real-time data infrastructure for financial AI. We aggregate signals across social, on-chain, and market data and give AI agents the tools to monitor, detect, and act on them instantly.

You can access it as a human, embed it in your product, consume it as an agent, or act on it directly. Execution happens wherever you trade.

What makes Elfa different​

  1. Context is king. Elfa goes beyond just "bullish" or "bearish." It tells you who is talking, whether they're credible, what entities are connected, and what the real story is — all grounded in a verified entity graph rather than raw unfiltered noise.
  2. A trigger engine, not just a dashboard. Elfa Auto lets you set conditions (price moves, TA signals, sentiment shifts, custom LLM prompts) and watches them 24/7. When your conditions align, you get triggered.
  3. Built for humans AND agents. Use the app to trade, embed the widget in your product, or let your agent consume intelligence via x402 pay-per-request (no API keys, no signup). Same data, same speed.
  4. Range. Elfa's infrastructure is data-source-agnostic, now delivering insights on on-chain commodities and tokenized equities. Whether it's Bitcoin, S&P500 or oil, you're getting the same depth of verified data across an expanding range of assets.

Want to try it? Go to elfa.ai, connect your wallet, and start asking questions. No coding required.

Three ways to use Elfa​

  • As a trader — Use Ask Elfa to understand the market, set up triggers with Auto, and trade directly inside the app — perps on Hyperliquid, HIP-3 tokens, or swap any on-chain token.
  • As a builder — Embed Elfa's intelligence as a widget in your product, or consume data through the REST API.
  • As an agent — Query Elfa via x402 pay-per-request in USDC on Base. No API key. No signup. No human in the loop.

Ask Elfa​

What is Ask Elfa?​

Ask Elfa is the natural-language terminal inside the Elfa app. It lets you:

  • Ask questions about tokens, markets, and narratives in plain English
  • Instantly understand why something is moving
  • Validate trade ideas without switching tabs or doing manual research
  • Request a trade setup analysis on any token

It's the fastest way for most users to interact with Elfa's intelligence.

How do I earn more Ask Elfa credits?​

  • Upgrade your plan. Higher subscription tiers come with more monthly credits (see Subscriptions).
  • Link your Telegram account. Unlocks an extra 150 credits every month.
  • Early user benefit. If you signed up before 5 Jan 2026, you get an extra 100 credits every month.
  • Buy credits. Directly purchase credits at any time.

What does one Ask Elfa query cost?​

It depends on the length and complexity of your query and the mode you're running. Expert mode costs more than Fast mode. Simple, short questions in Fast mode are the cheapest, while long, complex analyses in Expert mode are the most expensive.

Trading on Elfa​

Elfa isn't a trading product. It's an intelligence and trigger layer. But, because most users want to act on what they see, you can trade directly inside the Elfa app without leaving.

How does it work?​

Elfa supports two types of trading:

  • Perpetual futures — Powered by Hyperliquid Builder Code. Connect your Hyperliquid wallet and start trading perps on any listed token.
  • On-chain swaps — Powered by LiFi. Connect any on-chain wallet and swap any token across supported chains.

Both work inside the Elfa app. No need to leave the platform to execute.

What tokens can I trade on Elfa?​

  • Hyperliquid perps — All listed perp pairs including Solana ecosystem tokens like JUP, BONK, and more
  • Hyperliquid spot tokens — All listed spot tokens on Hyperliquid, powered by HyperUnit
  • HIP-3 perps — Third-party deployed perps listed on Hyperliquid
  • On-chain swaps — Swap any on-chain token directly on Elfa — all Solana tokens are supported

You don't need to leave Elfa to trade across different venues.

What's "Suggest Trade Setup"?​

Use it in the Ask Elfa terminal or the trading terminal's Ask Elfa tab. Pick a token. When Elfa finds a high-probability setup, you get:

  • Visual breakdown: where Elfa sees the move on the chart
  • Analysis: why the trade is being suggested
  • One-click trade: pre-filled limit, take-profit, stop-loss (you control leverage and size)

Suggest Trade Setup

How safe is the embedded wallet?​

Trading through Elfa uses an agent wallet authorized to sign trades on behalf of your main wallet, similar to how Hyperliquid handles trades on HyperCore. Elfa can execute your take-profit and stop-loss orders via the agent wallet but cannot move your funds or trade without your setup.

What fees does Elfa charge?​

  • Hyperliquid Base Fee: based on your 14-day weighted volume
  • Elfa Fee: 0.05% per trade

See Pricing for subscription tiers.

Do I have to trade on Elfa?​

No. Elfa's signals and triggers can drive execution anywhere you want: your own bot via webhook, another platform via builder codes, or manual execution. Trading inside Elfa is a convenience, not a requirement.

Elfa Auto​

What is Elfa Auto?​

Auto watches the market so you don't have to. Set the conditions you care about (price levels, volume changes, TA indicators, custom LLM prompts) and Auto monitors them continuously. When they align, you get triggered.

Example: "Alert me when Bitcoin's RSI drops below 30 AND 1h volume spikes." Auto watches both conditions at once and only pings you when they both hit.

What conditions can I set?​

  • Price: current price, price change %, high, low, volume
  • Technical analysis: RSI, MACD (value/signal/histogram), Bollinger Bands (upper/middle/lower), EMA, SMA, ATR, Stochastic (%K/%D), CCI, Williams %R
  • LLM-evaluated: custom natural-language conditions, e.g. "is sentiment for BTC bearish?" or "has this project announced a partnership?" (minimum evaluation period: 1h)
  • Time-based: cron/interval triggers (once, recurring, or remain-true)

Combine conditions with AND/OR logic. Example: (RSI oversold AND volume spike) OR (price change > 5% AND LLM detects negative sentiment).

Create a custom strategy on Elfa Auto

What happens when conditions trigger?​

Four action types:

  • Notify: execution is stored and available via polling
  • Webhook: HMAC-signed POST to your endpoint, with 3 retries and exponential backoff
  • Telegram: alert delivered to a Telegram bot or chat
  • LLM analysis: Auto runs an AI analysis (token analysis, discovery, macro summary, etc.) when conditions hit

You can attach multiple actions to one query. Auto is an alert layer. Execution happens downstream on whatever venue you trade on (Elfa's trading terminal, your own bot via webhook, or a partner platform via builder codes).

Real use cases​

  • "Wake me up on mean-reversion setups": RSI < 30 AND 1h volume > 2x 24h-avg triggers a Telegram ping
  • "Alert me when a token breaks out on sentiment": 1h sentiment > 0.6 AND 1h mindshare change > 3x fires a webhook into your own bot
  • "Run a discovery every Monday 9am": a cron trigger kicks off an LLM analysis of "what narratives are gaining mindshare this week"
  • "Tell me if someone credible says anything bearish about ETH": LLM: 'is this mention bearish toward ETH?' AND Smart Accounts only triggers a Telegram ping
  • "Monitor a partnership rumor": LLM: 'does this mention suggest a new partnership for $TOKEN' fires a webhook

How much does Auto cost?​

  • All credits are $0.009 each
  • Query creation: 5 credits ($0.045)
  • Fast LLM condition: +5 credits ($0.045)
  • Expert LLM condition: +18 credits ($0.162)
  • Allowed durations: 1h, 2h, 4h, 8h, 12h, 24h, 2d, 3d, 5d, 7d
  • No charge for validating, polling, cancelling, or listing sessions

For Developers & Agents​

How do I integrate Elfa?​

Two auth modes:

  • API Key mode (api.elfa.ai/v2): standard REST with key-based auth. Best for platforms and production integrations.
  • x402 mode (api.elfa.ai/x402/v2): pay-per-request in USDC on Base. No API key. No account. No human. Best for autonomous agents.

Get your API key at dev.elfa.ai. Full docs at docs.elfa.ai.

For read-only endpoints, the API key header is enough. For mutation endpoints (create query, builder chat, cancel query), HMAC signature headers are also required.

What data can I access via the API?​

  • Token social metrics (mentions, sentiment, mindshare, trending signals, trending contract addresses)
  • Entity relationship graph (verified connections between tokens, people, companies)
  • Real-time market data (price, volume, TA indicators)
  • Auto condition engine (create, validate, poll, and manage triggers programmatically)
  • LLM-powered analysis (token analysis, discovery, account analysis, macro summaries)
  • Event summaries and trending narratives

Some features (AI Chat, trending narratives, sentiment-weighted mentions) require Grow tier or above, or PAYG/x402.

How does x402 payment work?​

x402 is a pay-per-request protocol using USDC on Base.

  1. Your agent sends a request
  2. It receives a 402 response with payment requirements
  3. The agent signs a USDC transfer authorization
  4. It resends with the payment header
  5. Funds flow directly from your wallet to Elfa via xpay.sh (non-custodial)

Each request costs as low as $0.009 (1 credit).

For Auto x402 routes, also include the x-elfa-agent-secret header. Generate your secret once (openssl rand -hex 32) and reuse it permanently. Your agent identity is derived from SHA256(secret).

Client libraries: @x402/fetch (drop-in fetch wrapper), @x402/axios (Axios interceptor), @x402/evm (Base/USDC payment signing).

Quick integration example​

# x402 mode (no API key, no signup)
curl -X POST https://api.elfa.ai/x402/v2/auto/queries \
  -H "Content-Type: application/json" \
  -H "x-elfa-agent-secret: your-agent-secret" \
  -d '{
    "conditions": {
      "AND": [{
        "source": "ta",
        "method": "rsi",
        "args": { "symbol": "BTC", "timeframe": "1h", "period": 14 },
        "operator": "<",
        "value": 30
      }]
    },
    "actions": [{ "type": "notify" }],
    "expiresIn": "24h"
  }'

How fresh is the data?​

Seconds, not minutes. Entity extraction and sentiment scoring happen at ingest time, not query time. When you query a token's sentiment, the score was computed from data seconds old.

For Auto conditions, evaluation is continuous. Conditions are checked against live data streams, not periodic snapshots.

What if my webhook endpoint is down?​

Webhook delivery includes HMAC signature verification and retries 3 times with exponential backoff. Each delivery includes:

  • X-Auto-Event-Id for deduplication
  • X-Auto-Signature-Timestamp for replay window enforcement

If all retries fail, the execution is logged and available via the polling endpoint.

How is Elfa's data different from raw Twitter/social API access?​

Raw social APIs give you firehose data (millions of posts, mostly irrelevant, spam and bots). Elfa does the processing for you:

  • Entity extraction (which tokens are actually discussed)
  • Organic-attention filtering (bot/spam/hype removed)
  • Structured signals (sentiment, mention velocity, mindshare %)
  • Verified entity graph for relationship context
  • Delivered as structured, queryable data, not raw text

Insights from Elfa on CoinGecko

Can I embed Elfa in my product?​

Yes. The embeddable widget gives your users AI-powered crypto intelligence inside your platform, with:

  • Custom branding and color schemes
  • User-persona and company-documentation injection
  • Drop-in install: single block of code

Contact the team for widget pricing and setup.

Can I use Elfa for non-crypto data?​

Elfa currently focuses on crypto. The infrastructure is data-source agnostic: the same ingestion pipelines, entity graph, and condition engine can work with any structured data. Elfa has already integrated tokenized equities and commodities, with the roadmap covering the full range of equities, regulatory events, macro indicators, and political markets.

The Data Behind Elfa​

Where does Elfa get its data from?​

Elfa ingests and processes data from multiple public sources in real-time:

  • X (Twitter): conversations, KOL activity, sentiment
  • Telegram: group discussions, announcement channels
  • DEX and CEX market data: price, volume, order flow
  • Fund flow data: exchange flows, ETF inflows/outflows
  • News and announcements: verified through entity graph matching
  • Technical indicators: RSI, MACD, Bollinger Bands, EMA, SMA, ATR, Stochastic, CCI, Williams %R, computed in real-time from market data

Elfa's entity graph connects tokens, people, companies, and events using verified sources (documentation, official announcements) rather than unverified social commentary. Relationships are grounded in facts, not noise.

What is the Entity Graph?​

The entity graph is the structured map that connects everything Elfa tracks. Every token, project, person, company, and event is a node. Every verified relationship is an edge.

Example: Uniswap Labs -> employs -> Hayden Adams -> frequently tweets about -> $UNI -> governed by -> Uniswap DAO -> contains proposal -> [active-proposal-id].

When a mention comes in ("Hayden just tweeted about a new UNI proposal"), Elfa knows — from the graph — that this mention is about Uniswap governance, not retail speculation. Your sentiment score for $UNI is weighted by who said it and what they're actually talking about.

What tokens does Elfa cover?​

Every token in the crypto universe, including newly launched tokens. This includes all Solana tokens, all EVM tokens, and everything listed on major DEXs and CEXs.

Unlike platforms that require manual listing or minimum thresholds, Elfa automatically detects new tokens as social discussion forms around them.

Can I search for tokens not yet indexed?​

Yes. Elfa has an on-demand search feature. Paste any token contract address and Elfa will search, track, and analyze it in real-time — even if it's not yet officially indexed. Every token is accessible from day one.

What does Mindshare represent?​

Mindshare is the percentage of total crypto discussion focused on a specific token within a given time window.

Example: If ETH has 10% mindshare on the 1-hour leaderboard, 10% of all token mentions in the past hour were about ETH.

This tracks where organic attention is flowing before price reacts.

Track Mindshare and Mindshare changes on the Explore tab

Does Elfa have a token?​

No.

Account & Support​

  1. Click the 4-squares icon (top right)

Click the 4-squares icon

  1. Go to Settings

Go to Settings

  1. Click Connect to Telegram

Connect to Telegram

How do I let friends try Elfa?​

Every beta user gets 20 invite codes. Find your invite link via the Invite button (the gift box icon in the top right corner). On mobile, the Invite button can be found in the top right corner of your Profile tab.

Invite button

I'm facing a bug​

Try these:

  • Ping us in Elfa Roast Club on Telegram. Devs respond fast.
  • For API/integration issues, reach out via the developer support channel
  • Log out and back in
  • Clear cache

How do I clear cache?​

  • Desktop: Ctrl/Cmd + Shift + Delete
  • Safari (iOS): Settings > Apps > Safari > Advanced > Website Data > Remove All
  • Chrome (iOS): Chrome > ... > Settings > Privacy & Security > Delete Browsing Data > Cached Images and Files
  • Chrome (Android): Chrome > ... > Settings > Privacy & Security > Delete Browsing Data > All time > Cached images and files