Hyperfolio API

Hyperfolio API is an onchain HyperEVM portfolio tracking API designed to support builder use cases. Builders can also fetch real-time Hyperbeat data, like vault yield metrics and more to power frontends.

Learn more here

Get comprehensive vault data with positions and volume metrics

get

Retrieve complete vault analytics including multi-timeframe APYs, hourly TVL history, oracle data, performance metrics, real-time position breakdowns, and delta neutral volume data. Position data includes combined Hyperliquid basis trades (spot+perp), net DeFi positions (supply-borrow), and filtered liability positions. Volume metrics include 24h spot/perp trading volumes, position values, and leverage data for delta neutral strategies. Optimized for real-time monitoring and historical analysis.

Authorizations

x-api-key

x-api-keystringRequired

API key needed to access the endpoints

Path parameters

addressstringRequired

Vault contract address

Example: 0x5e105266db42f78FA814322Bce7f388B4C2e61eb

Responses

200

Vault data retrieved successfully

application/json

404

Vault not found

get

/vault-infos/{address}

HTTPcURLJavaScriptPython

GET /vault-infos/{address} HTTP/1.1
Host: 
x-api-key: YOUR_API_KEY
Accept: */*

{
  "vaultInfo": {
    "address": "text",
    "symbol": "text",
    "name": "text",
    "provider": "text",
    "description": "text",
    "chain": "text",
    "chainId": 1,
    "coingeckoId": "text",
    "deployedBlock": 1,
    "type": "text",
    "oracle": "text",
    "tokenPriceOracle": "text"
  },
  "currentAPY": {
    "apy_1d": 12.8,
    "apy_3d": 14.1,
    "apy_7d": 15.42,
    "apy_30d": 16.7,
    "apy_since_launch": 18.3,
    "timestamp": 1704725400000,
    "lastUpdated": "2025-01-08T15:30:00.000Z"
  },
  "currentTVL": {
    "totalValueLocked": 1250000.42,
    "sharePrice": 1.0245,
    "timestamp": 1704725400000,
    "lastUpdated": "2025-01-08T15:30:00.000Z"
  },
  "currentVolume": {
    "spotVolume24h": 479.25,
    "perpVolume24h": 479.25,
    "totalVolume24h": 958.5,
    "perpValue": 25000,
    "spotValue": 25000,
    "idleValue": 5000,
    "shortLeverage": 2.15,
    "lastUpdated": "2025-01-08T15:30:00.000Z",
    "timestamp": 1704725400000
  },
  "currentPositions": {
    "summary": {
      "totalValue": 96770000,
      "count": 13,
      "lastUpdated": "2025-08-03T14:59:13.278221+00:00"
    },
    "breakdown": [
      {
        "protocol": "Hyperliquid",
        "position": "HYPE basis trade",
        "allocation": 39.78,
        "value": 39849326.11
      }
    ]
  },
  "history": {
    "fullAPYHistory": [
      {
        "date": "2025-01-08",
        "apy": 15.42,
        "apy_1d": 12.8,
        "apy_3d": 14.1,
        "apy_7d": 15.42,
        "apy_30d": 16.7,
        "apy_since_launch": 18.3,
        "timestamp": 1704725400
      }
    ],
    "apy1dChart": [
      {
        "date": "2025-01-08",
        "value": 12.8,
        "timestamp": 1704725400
      }
    ],
    "apy7dChart": [
      {
        "date": "2025-01-08",
        "value": 15.42,
        "timestamp": 1704725400
      }
    ],
    "tvlHistory": [
      {
        "date": "2025-01-08",
        "datetime": "2025-01-08T15:30:00.000Z",
        "total_value_locked": 1250000.42,
        "share_price": 1.0245,
        "timestamp": 1704725400,
        "created_at": "2025-01-08T15:30:15.000Z"
      }
    ],
    "exchangeRates": [
      {
        "data": 102450000,
        "round_id": 123456,
        "timestamp": 1704725400,
        "created_at": "2025-01-08T15:30:00.000Z"
      }
    ]
  },
  "configuration": {},
  "metadata": {
    "totalAPYRecords": 156,
    "totalTVLRecords": 2847,
    "totalExchangeRates": 35,
    "totalPositions": 13,
    "lastUpdated": "2025-01-08T15:30:00.000Z"
  }
}

The above endpoint is only available for Midas Vaults. (i.e. hbUSDT, lstHYPE, XAUt, beHYPE pre-deposit)