Live public evidence / Hyperliquid vault researchNo custody / no execution / independent analytics
VaultVisionHL · Vault research
Live evidence
Menu
Track my HL
Public data / read only / agent ready

Hyperliquid vault API and MCP server

Give ChatGPT, Claude, compatible agents, or your own code current VaultVision data for vault search, rankings, risk, drawdown, TVL, deposit status, entry quality, and alerts. No API key is required.

Connect an AI agent Try vaults endpoint Open OpenAPI spec Open vault scanner View vault rankings
FormatsMCP + JSON over HTTPS
AccessNo authentication
Rate limit60 requests / minute / IP
Live statusChecking API

Connect an AI agent

Add https://vaultvision.tech/mcp as a remote Streamable HTTP MCP server. The tools are stateless and read-only: they can retrieve current research evidence but cannot trade, connect a wallet, sign, deposit, or withdraw.

Research tools

  • searchFind vault entities and canonical research pages.
  • fetchRetrieve a result with timestamped evidence.
  • search_vaultsFilter by TVL, risk, drawdown, deposit state, and entry label.
  • compare_vaultsCompare two to five vaults without choosing a winner.
  • explain_vault_riskRead the score, components, reasons, drawdown, and caveats.
  • get_recent_alertsRead monitoring signals, never execution instructions.

Evidence contract

  • checked_atUTC time when VaultVision assembled the response.
  • updated_tsRow-level source freshness when available.
  • canonical_urlCrawlable VaultVision page an answer can cite.
  • sourceObserved or derived provenance for the result.
  • caveatExplicit limits on return, rank, risk, and deposit state.
MCP discovery check
curl -s https://vaultvision.tech/mcp \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{}}'

When an answer uses VaultVision, retain the checked timestamp and link the canonical source page. APR and historical returns are variable; risk and entry scores are first-party models, not guarantees or personalized advice.

Endpoints

The public v1 surface is deliberately small. It is read-only and does not place trades, copy positions, connect wallets, or submit deposits.

SPEC
/openapi.json

OpenAPI 3.0 contract for client generation, schema inspection, and catalog validation.

Open contract
GET
/api/v1/health

Service freshness and tracked protocol counts.

Open JSON
GET
/api/v1/vaults

Active vault records with TVL, APR, 30/90-day return, 30-day max drawdown, risk, entry quality, deposit availability, coverage, and canonical product URLs.Params: protocol, limit (1-500)

Open JSON
GET
/api/v1/vaults/<vault_id>

One vault plus its latest risk components, entry context, expectations when available, and recent snapshots.

Find vault ID
GET
/api/v1/rankings/risk-adjusted

Current risk-adjusted ranking snapshot with score, TVL, APR, risk band, entry score, and canonical vault URL.Alternative types: verified, estimated. Param: limit (1-200)

Open JSON
GET
/api/v1/signals

Recent rule-based changes such as entry deterioration, TVL outflow, APR movement, and risk jumps. Signals are research context, not trade instructions.Params: since_ts, limit (1-1000)

Open JSON

Quick start

Request the current Hyperliquid vault universe, then follow each vaultvision_url to the crawlable product page for positions, drawdown, flow, and decision context.

Shell
curl -s "https://vaultvision.tech/openapi.json"

curl -s "https://vaultvision.tech/api/v1/vaults?protocol=hyperliquid&limit=20"

curl -s "https://vaultvision.tech/api/v1/rankings/risk-adjusted?limit=10"

curl -s "https://vaultvision.tech/api/v1/signals?since_ts=1784246400&limit=20"

Data contract

Values are current observations or VaultVision model outputs. They are not promises of future performance. Null means the field is not available for that vault or window.

Observed vault fields

  • tvl_usdCurrent vault equity in USD terms.
  • aprCurrent annualized performance value as a decimal, not a guaranteed yield.
  • cum_return_30dDeposit-neutral cumulative 30-day return as a decimal when coverage exists.
  • cum_return_90dDeposit-neutral cumulative 90-day return as a decimal when coverage exists.
  • max_drawdown_30dDerived peak-to-trough drawdown over the recent 30-day window.
  • analytics_date_tsDay bucket for return and drawdown fields.
  • updated_tsUnix timestamp for the vault record.
  • accepts_depositsObserved deposit availability when the source supports it.
  • deposit_capacity_usdEstimated remaining capacity when available.
  • vaultvision_urlCanonical crawlable vault detail page.

VaultVision model fields

  • risk_scoreFirst-party 0-100 model; lower means lower modeled risk.
  • risk_bandLow, moderate, or high modeled risk band.
  • entry_scoreCurrent entry-quality model, not a recommendation.
  • entry_labelGood Entry, Neutral, or Avoid based on current inputs.
  • quality_labelSource-quality label such as real or derived.
  • rank_risk_adjustedCurrent model rank when the vault qualifies.

Freshness and boundaries

Check /api/v1/health before depending on the latest values. The API is a research surface, not an execution service.

VaultVision does not guarantee uptime, ranking persistence, deposit availability, future return, or loss avoidance. Risk and entry fields are first-party models. Revalidate current positions, drawdown, lockup, capacity, and vault status before making a capital decision.

For the protocol context behind builder-deployed markets and current outcome limits, read HIP-3 and HIP-4 on Hyperliquid.

Use the data in context

Move from JSON to a real vault screen before acting on one metric.

Open scanner Public vault reads