Documentation

Everything an integration needs — human- and AI-readable.

Building with an AI assistant? Give it one link — it contains the complete contract, templates and requirements:

https://vaultomate.xyz/llms.txt

Prompt suggestion: "Read https://vaultomate.xyz/llms.txt and connect my strategy to a Vaultomate vault. Ask me for my API key when needed."

Already deployed? Operate your vault — mode, test signals, revenue — at /terminal (your API key is the login).

Requirements — before you start

A wallet (MetaMask or any EVM wallet) on HyperEVM mainnet — chain id 999, RPC https://rpc.hyperliquid.xyz/evm (the create flow adds the network for you)
~$2 of HYPE on HyperEVM — one-time gas + the vault bot/oracle gas funds (paid to the network, we add no setup fee). After deploy, the platform's gas keeper monitors and refills your vault's gas automatically — you never babysit HYPE.
$18+ USDC on HyperEVM — $3 vault operations float + $15 minimum trading capital (the capital stays yours)
TradingView route: Plus plan or higher + 2FA enabled (Essential does NOT include webhook alerts — verified 2026-07-06; ~€30/mo monthly)
Your revenue: performance fee 0–30% (you set it, on gains above the high-water mark) + optional volume markup 0–3.5 bps on your exit fills — paid to your wallet by Hyperliquid directly (needs ≥$100 in your HL perps to accrue; earns on signal-closed exits, not stop-triggered ones)
Markets (live path today): SOL, BTC, ETH perps. "coin" is the plain symbol ("SOL"); TradingView tickers (HYPERLIQUID:SOLUSDC.P etc.) normalize automatically. Shadow rehearses any Hyperliquid coin and flags unsupported ones.

TradingView — paste one template

{
  "api_key": "vf_YOUR_KEY",
  "position": "{{strategy.market_position}}",
  "ticker": "{{ticker}}",
  "risk_pct": 1.0,
  "sl_pct": 2.0,
  "client_id": "{{timenow}}"
}

Webhook URL: https://vaultomate.xyz/v1/signal/tv · full walkthrough: /connect/tv

Python — six lines

import requests, time
requests.post("https://vaultomate.xyz/v1/signal",
    headers={"Authorization": "Bearer vf_YOUR_KEY"},
    json={"target": "long", "coin": "SOL", "order": "market", "risk_pct": 1.0,
          "sl": 78.6, "ts": time.time(),
          "client_id": f"my-{int(time.time()*1000)}"})

The contract in one breath

Declare the target state — long / short / flat. Not buy/sell actions.
Size by risk — risk_pct = % of equity lost if the stop hits; size is derived.
Stops are mandatory on entries and rest on-exchange.
Entries are price-guarded — moved past the guard? Skipped, never chased.
client_id makes every signal idempotent — retries are safe.
Shadow first — new vaults validate + size without sending orders; flip live when ready.

How fees work

Builder fee — entries	2.5 bps → us, on every entry fill. This is how the platform earns.
Builder fee — exits	your markup, 0–3.5 bps → your wallet, on exit fills. You set it. Paid by Hyperliquid directly — no invoices. Separate fill, separate builder (not a split of one fill). Per-fill cap: 5 bps.
Exchange fee	Hyperliquid's, not ours: ~4.5 bps taker / 1.5 bps maker per fill.
Performance fee	0–30% → you, on gains above the high-water mark. Your main revenue.
Everything else	None. No management fee, no subscription, no listing fee.

Two caveats we say out loud: your markup needs ≥$100 in your Hyperliquid perps account to accrue (below that, exits fall back to our 2.5 bps), and it earns on signal-closed exits — a stop-triggered exit carries our fee, because the stop was placed at entry. Every number on your record page is net of all of this.

Metrics — how they're computed

Return — share-price change since inception, net of all fees, read from settled NAV.
Sharpe · Sortino — annualized from settled daily returns only (never the live estimate); locked below 30 settled days because fewer observations are statistical noise.
BTC correlation — Pearson correlation of the vault's settled daily NAV returns vs BTC's returns over the same settlement-to-settlement windows (BTC priced from Hyperliquid 1h closes, UTC). |r| ≤ 0.30 reads as low correlation — market-neutral-ish. Same 30-day lock as Sharpe.
Max drawdown, win rate, profit factor — computed from the full fill history at page load; nothing is self-reported or cached server-side.

Capital at risk · not financial advice · every claim verifiable on-chain