Coinversaa Pulse

Crypto intelligence for AI agents. 7 free tools + 32 premium tools for Hyperliquid trader analytics, behavioral cohorts, syncer-backed risk data, live market...

Security Scan

The skill's instructions, required settings, and scope match its crypto analytics purpose; it asks only for an optional API key and tells the agent to run an npm MCP server — nothing appears incoherent, but running remote npm code (npx) is an expected but non-trivial supply-chain risk you should consider.

Purpose & Capability

The name/description (crypto intelligence, MCP-compatible tools) map to the actions in SKILL.md: it exposes MCP tools and documents adding an MCP server via npx @coinversaa/mcp-server and optionally providing COINVERSAA_API_KEY. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md stays on-topic: it documents free vs API-key tiers, lists tools and rate limits, and provides concrete instructions for adding an MCP server and setting COINVERSAA_API_KEY in agent configs. It does instruct editing local agent config files (e.g., Claude and Cursor config paths) and to run npx which will fetch and run remote package code — this is expected for this capability but is an action that executes third-party code and touches local app config files.

Install Mechanism

There is no packaged install spec, but the runtime instructions rely on npx -y @coinversaa/mcp-server. That will download and execute an npm package from the registry (supply-chain risk). This is proportionate for a connector but is a moderate operational risk compared to instruction-only skills that never fetch code.

Credentials

Only optional environment variables are documented (COINVERSAA_API_KEY, COINVERSAA_API_URL). COINVERSAA_API_KEY is optional (7 free tools without a key) and is appropriate for unlocking paid features. No unrelated tokens (AWS, SSH, wallets, etc.) are requested.

Persistence & Privilege

always:false and normal autonomous invocation are in effect. The skill suggests writing entries to local agent config files to register the MCP server — this is expected and limited to the user's agent configuration; the skill does not request system-wide privileges or to modify other skills.

Assessment

This skill appears internally consistent with its stated purpose, but review these points before installing: - npx executes remote npm code: the SKILL.md instructs running `npx -y @coinversaa/mcp-server`. That will download and run code from the npm registry. If you are concerned about supply-chain risk, inspect the @coinversaa/mcp-server package source (repository listed as https://github.com/coinversaa/mcp-server), check maintainers, versions, and ideally review the package before running it. - API key is optional: you can use 7 free tools without providing credentials. If you do provide COINVERSAA_API_KEY, only give it to this connector and avoid pasting keys into shared locations. The SKILL.md documents the key prefix (cvsa_) and an optional COINVERSAA_API_URL. - Config file edits are local: the skill tells you how to add the MCP entry to local agent config files (Claude, Cursor, OpenClaw). These are expected setup steps but will change agent behavior by registering the connector — only perform if you trust coinversaa.ai and the npm package. - Trading-related caution: the documentation mentions backend-signed orders and approvals on Hyperliquid. The skill does not request wallet keys, but if you plan agentic trading, understand who signs orders (their backend signer) and do not share private wallet keys or vault credentials unless you explicitly intend to enable trading with that service. - If you want higher assurance: verify the npm package checksum/release on the repository, review the repository code, and prefer installing pinned versions rather than allowing npx to fetch the latest by default. If you want, I can: summarize the SKILL.md fully, extract the exact list of tools and rate limits, or fetch the GitHub repo link to show where to audit the npm package.

Crypto intelligence for AI agents. Query 710K+ Hyperliquid wallets, 1.8B+ trades, behavioral cohorts, and live market data through any MCP-compatible client.

This is not a wrapper around a public blockchain API. Coinversaa indexes Hyperliquid's clearinghouse directly and computes analytics that don't exist anywhere else.

Now with builder dex support — 369+ markets across 8 dexes including commodities, stocks, indices, and perps.

Setup

Option A: Free Tier (No API Key)

Try it instantly — no sign-up needed. 7 tools with rate limits:

Free Tool	Rate Limit
pulse_global_stats	10/min
pulse_market_overview	5/min
list_markets	5/min
market_price	30/min
market_orderbook	10/min
pulse_most_traded_coins	5/min
live_long_short_ratio	5/min

Daily cap: 500 requests/day per IP.

{
  "mcpServers": {
    "coinversaa": {
      "command": "npx",
      "args": ["-y", "@coinversaa/mcp-server"]
    }
  }
}

Option B: Full Access (API Key — 39 tools)

Get a key at coinversaa.ai/developers — unlocks all 39 tools with higher rate limits (100 req/min, no daily cap).

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coinversaa": {
      "command": "npx",
      "args": ["-y", "@coinversaa/mcp-server"],
      "env": {
        "COINVERSAA_API_KEY": "cvsa_your_key_here"
      }
    }
  }
}

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "coinversaa": {
      "command": "npx",
      "args": ["-y", "@coinversaa/mcp-server"],
      "env": {
        "COINVERSAA_API_KEY": "cvsa_your_key_here"
      }
    }
  }
}

Claude Code:

claude mcp add coinversaa -- npx -y @coinversaa/mcp-server
export COINVERSAA_API_KEY="cvsa_your_key_here"

OpenClaw:

npx clawhub install coinversaa-pulse

Builder Dex Markets

Hyperliquid supports multiple builder dexes beyond the native perps exchange. Each dex has its own markets, collateral token, and symbol format.

Dex	What it trades	Collateral	Example symbols
(native)	Core perps (crypto)	USDC	BTC, ETH, SOL, HYPE
xyz	Commodities, stocks, indices	USDC	xyz:GOLD, xyz:SILVER, xyz:TSLA
flx	Perps	USDH	flx:BTC, flx:ETH
vntl	Perps	USDH	vntl:ANTHROPIC, vntl:BTC
hyna	Perps	USDE	hyna:SOL, hyna:BTC
km	Energy & commodities	USDH	km:OIL, km:NATGAS
abcd	Misc	USDC	abcd:BITCOIN
cash	Stocks & equities	USDT0	cash:TSLA, cash:AAPL

Symbol format:

• Native Hyperliquid: BTC, ETH, SOL
• Builder dex: prefix:COIN — e.g. xyz:GOLD, cash:TSLA, hyna:SOL

Use the list_markets tool to discover all available symbols and which dex they belong to.

Backend trading note for agentic traders: Coinversaa's backend-signed Hyperliquid orders rely on an approved Hyperliquid agent wallet, not a vaultAddress. If the backend signer changes, it must be re-approved on Hyperliquid before orders will succeed. Builder dex orders may also require unified account mode so USDC collateral is shared across supported dexes. For isolated-only markets, omitted marginMode now defaults to isolated; do not assume cross is available on builder dex symbols.

Tools (39 total — 7 free, 32 require API key)

Risk Tools Freshness

Syncer-backed risk tools such as live_risk_overview, live_coin_risk_snapshot, live_coin_risk_history, live_mark_dislocations, live_recent_liquidations, live_liquidation_summary, live_oi_history, and live_cohort_bias_history are best treated as beta recent-intelligence tools.

• Best for research, LLM training, liquidation analysis, OI trend work, and crowding detection
• Best queried over recent windows like 7d or 30d
• Freshness depends on sync coverage and may lag real time
• Do not treat them as guaranteed live execution truth or exact historical accounting

How AI Agents Use The Risk Tools

These tools are useful when the user wants market-structure answers, not just raw rows.

Goal	Best tools	What they help answer
Detect risk now	live_risk_overview, live_coin_risk_snapshot	"What looks fragile right now?", "Is this coin crowded?", "Who is holding the risk?"
Explain recent stress	live_recent_liquidations, live_liquidation_summary, live_mark_dislocations	"What got liquidated?", "Did basis stress show up before the unwind?", "Was this move liquidation-driven?"
Track regime change	live_coin_risk_history, live_oi_history, live_cohort_bias_history	"Did OI build into this move?", "Did smart money rotate early?", "How did the setup change over the last month?"

For agent UX, prefer recent windows like 7d or 30d and summarize outputs in plain language instead of dumping all rows unless the user asks for raw detail.

For market_recent_candles, keep requests short and recent. The MCP tool intentionally caps one-minute candle responses at 720 rows (12h) so agents do not pull massive minute-bar dumps in a single call.

Pulse — Trader Intelligence

Use these tools when the user asks about top traders, market activity, or trading trends.

• pulse_global_stats — Global Hyperliquid stats: total traders, trades, volume, PnL, data coverage period. Use when asked about overall market scale.
• pulse_market_overview — Full market state: 24h volume, open interest, mark prices, funding rates, 24h change for every pair. Optional dex param to filter by builder dex (hl, xyz, flx, vntl, hyna, km, abcd, cash).
  • Parameters: dex (optional)
• list_markets — Discover all available markets across all dexes. Returns each market's dex, mark price, 24h volume, funding rate, open interest, and 24h change. Use when a user asks "what markets are available?" or mentions a commodity/stock.
  • Parameters: dex (optional — filter to a specific builder dex)
• pulse_leaderboard — Ranked trader leaderboard. Sort by pnl, winrate, volume, score, risk-adjusted, or losers. Filter by period (day/week/month/allTime) and minimum trades.
  • Parameters: sort, period, limit (1-100), minTrades
• pulse_hidden_gems — Underrated high-performers most platforms miss. Filter by min win rate, PnL, trade count.
  • Parameters: minWinRate, minPnl, minTrades, maxTrades, limit (1-100)
• pulse_most_traded_coins — Most actively traded coins ranked by volume and trade count.
  • Parameters: limit (1-100)
• pulse_biggest_trades — Biggest winning or losing trades across all of Hyperliquid.
  • Parameters: type (wins/losses), limit (1-50), threshold
• pulse_recent_trades — Biggest trades in the last N minutes/hours sorted by absolute PnL.
  • Parameters: since (e.g. 10m, 1h, 1d), limit (1-100), coin (optional)
• pulse_token_leaderboard — Top traders for a specific coin.
  • Parameters: coin, limit (1-100)
• market_historical_oi — Historical hourly open interest snapshots (notional USD). Supports per-coin filtering or global aggregate.
  • Parameters: coin (optional), since (max 30d), startTime (optional), endTime (optional)
• market_recent_candles — Recent 1-minute candles for a market. Useful for short intraday structure checks, recent momentum, and micro-pullback analysis. Intentionally capped to the last 12 hours to keep MCP responses practical.
  • Parameters: symbol, limit (1-720)

Pulse — Trader Profiles

Use these tools for deep dives on specific wallets. Any tool taking address expects a full Ethereum address (0x + 40 hex chars).

• pulse_trader_profile — Full due diligence: total PnL, trade count, win rate, volume, largest win/loss, first/last trade dates, PnL tier, size tier, profit factor.
  • Parameters: address
• pulse_trader_performance — 30-day vs all-time comparison with trend direction (improving/declining/stable).
  • Parameters: address
• pulse_trader_trades — Recent trades for any wallet: every buy, sell, size, price, PnL.
  • Parameters: address, since, limit (1-100), coin (optional)
• pulse_trader_daily_stats — Day-by-day PnL, trade count, win rate, volume.
  • Parameters: address
• pulse_trader_token_stats — Per-coin P&L breakdown.
  • Parameters: address
• pulse_trader_closed_positions — Full position history: entry/exit prices, hold duration, PnL, leverage.
  • Parameters: address, limit (1-200), offset, coin (optional)
• pulse_trader_closed_position_stats — Aggregate closed position stats: avg hold duration, position win rate, total closed, PnL summary.
  • Parameters: address

Pulse — Cohort Intelligence

Coinversaa classifies 710K+ wallets into behavioral tiers. This is unique data nobody else has.

PnL tiers (by profitability): money_printer, smart_money, grinder, humble_earner, exit_liquidity, semi_rekt, full_rekt, giga_rekt

Size tiers (by volume): leviathan, tidal_whale, whale, small_whale, apex_predator, dolphin, fish, shrimp

• pulse_cohort_summary — Full behavioral breakdown across all wallets. Each tier shows wallet count, avg PnL, avg win rate, total volume.
• pulse_cohort_positions — What a specific cohort is holding RIGHT NOW.
  • Parameters: tierType (pnl/size), tier, limit (1-200)
• pulse_cohort_trades — Every trade a cohort made in a time window.
  • Parameters: tierType, tier, since, limit (1-100)
• pulse_cohort_history — Day-by-day historical performance for a cohort.
  • Parameters: tierType, tier, days (1-365)
• pulse_cohort_bias_history — Historical hourly bias snapshots for all trader cohorts.
  • Parameters: coin (optional), since (max 30d), startTime, endTime
• pulse_cohort_performance_daily — Historical daily performance stats for all cohorts.
  • Parameters: since (max 30d), startTime, endTime

Market — Live Data

Real-time market data directly from Hyperliquid.

• market_price — Current mark price for any symbol (native or builder dex, e.g. BTC, xyz:GOLD).
  • Parameters: symbol
• market_positions — All open positions for any wallet with entries, sizes, unrealized PnL, leverage.
  • Parameters: address
• market_orderbook — Bid/ask depth for any pair.
  • Parameters: symbol, depth (1-50)

Live — Real-Time Analytics

Derived analytics computed in real-time.

• live_liquidation_heatmap — Liquidation clusters across price levels for any coin.
  • Parameters: coin, buckets (10-100), range (1-50% around current price)
• live_risk_overview — Exchange-wide risk snapshot: OI, leverage, crowding concentration, near-liquidation exposure, and 7-day liquidation totals.
• live_coin_risk_snapshot — Current risk snapshot for a single coin: OI, wallet count, concentration, top positions, liquidation heatmap, and recent liquidations.
  • Parameters: coin
• live_coin_risk_history — Historical risk lane for a coin: OI, long/short, cohort rotation, candles, dislocations, and liquidation flow.
  • Parameters: coin, hours (1-720)
• live_mark_dislocations — Historical mark/oracle dislocation series for a coin with mark price, oracle price, and basis percentage.
  • Parameters: coin, hours (1-720)
• live_recent_liquidations — Real liquidation events from the syncer with wallet, coin, penalty fee, and closed PnL.
  • Parameters: since, coin (optional), limit (1-200)
• live_liquidation_summary — Aggregated liquidation stats over a window with by-coin rollups and timeline buckets.
  • Parameters: since, coin (optional)
• live_long_short_ratio — Global or per-coin long/short ratio with optional history.
  • Parameters: coin (optional), hours (optional, 1-168 for history)
• live_cohort_bias — Net long/short stance for every tier on a given coin.
  • Parameters: coin
• live_oi_history — Historical open interest for any coin or global, using hourly snapshots up to 30 days.
  • Parameters: coin (optional), hours (1-720)
• live_cohort_bias_history — Historical hourly long/short bias shifts for a specific coin across all cohorts or a single tier.
  • Parameters: coin, tierType, tier (optional), hours (1-720)
• pulse_recent_closed_positions — Positions just closed across all traders. Filterable by coin, size, and hold duration.
  • Parameters: since, limit (1-200), coin, minNotional, minDuration, maxDuration

Example Prompts

Once connected, try asking your AI:

• "What are the top 5 traders on Hyperliquid by PnL?"
• "Show me what the money_printer tier is holding right now"
• "What are the biggest trades in the last 10 minutes?"
• "Find underrated traders with 70%+ win rate"
• "Do a deep dive on wallet 0x7fda...7d1 — are they still performing?"
• "Where are the BTC liquidation clusters?"
• "Show me the exchange-wide risk overview on Hyperliquid this week"
• "Which coin looks the most crowded right now?"
• "Show me ETH liquidation events from the last 7 days"
• "Give me BTC risk history with OI, liquidations, and cohort rotation"
• "Are smart money traders long or short ETH right now?"
• "What coins are most actively traded right now?"
• "Show me the biggest losses in the last 24 hours"
• "Is this trader a scalper or swing trader? What's their average hold time?"
• "Which coins does this trader actually make money on?"
• "What did the whale tier trade in the last hour?"
• "Compare this trader's last 30 days to their all-time performance"
• "What markets are available on the xyz dex?"
• "Show me all commodity markets (gold, silver, oil)"
• "What's the price of xyz:GOLD?"
• "List all builder dex markets"
• "What stocks can I trade on Hyperliquid?"

What Makes This Different

• Builder dex markets: 369+ markets across 8 dexes — commodities, stocks, indices, and perps
• Behavioral cohorts: 710K wallets classified into PnL tiers (money_printer to giga_rekt) and size tiers (leviathan to shrimp)
• Live cohort positions: See what the best traders are holding in real-time
• Real-time trade feed: Every trade by any wallet or cohort, queryable by time window
• Liquidation heatmaps: Cluster analysis across price levels for any coin
• Closed position analytics: Full position lifecycle with hold duration and entry/exit analysis
• Hidden gem discovery: Find skilled traders that ranking sites miss
• 1.8B+ trades indexed: The deepest Hyperliquid dataset available as an API

Rate Limits

Free tier: Per-route limits (5-30/min) + 500 requests/day per IP. See the table in Setup for details.

Paid tier (API key): 100 requests/minute, no daily cap.

Rate limit headers are included in every response:

• X-RateLimit-Limit: your configured limit
• X-RateLimit-Remaining: requests left in current window
• X-RateLimit-Reset: seconds until window resets
• X-RateLimit-Tier: free or paid
• X-RateLimit-Daily-Remaining: (free tier only) requests left today

Links

• Website: coinversaa.ai
• API Docs: coinversaa.ai/developers
• GitHub: github.com/coinversaa/mcp-server
• npm: @coinversaa/mcp-server
• Support: [e-mail]

---

Built by Coinversaa — Crypto intelligence for AI agents.