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

get

Retrieve complete vault analytics including multi-timeframe APYs, hourly TVL history, oracle data, performance metrics, and real-time position breakdowns. Position data includes combined Hyperliquid basis trades (spot+perp), net DeFi positions (supply-borrow), and filtered liability positions. Optimized for real-time monitoring and historical analysis.

Authorizations

Path parameters

addressstringRequired

Vault contract address

Example: 0x5e105266db42f78FA814322Bce7f388B4C2e61eb

Responses

200

Vault data retrieved successfully

application/json

404

Vault not found

get

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"
  },
  "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)