Hyperliquid HLP vault snapshot + history (TVL, PnL, APR, followers).

HLP is Hyperliquid's flagship house vault — the one most retail depositors follow because it absorbs flow from the protocol itself. This endpoint gives you the latest snapshot plus a time series suitable for charting TVL curves or benchmarking APR over the trailing window. We key off the vault name, so a future HLP relaunch will still resolve cleanly.

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  latest: {
    ts: number;
    vaultAddress: string;
    name: string | null;
    leader: string | null;
    tvl: number | null;
    pnlDaily: number | null;
    pnlWeekly: number | null;
    pnlAllTime: number | null;
    apr: number | null;
    followers: number | null;
  } | null;
  history: Array<SameShapeAsLatest>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/hyperliquid/vault/hlp?days=7" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": {
    "latest": {
      "ts": 1744834800000,
      "vaultAddress": "0x1719884eb866cb12b2287399b15f7db5e7d775ea",
      "name": "HLP",
      "leader": null,
      "tvl": 512000000,
      "pnlDaily": 120000,
      "pnlWeekly": 880000,
      "pnlAllTime": 41200000,
      "apr": 0.185,
      "followers": 28000
    },
    "history": [
      {
        "ts": 1744230000000,
        "vaultAddress": "0x1719884eb866cb12b2287399b15f7db5e7d775ea",
        "name": "HLP",
        "leader": null,
        "tvl": 501200000,
        "pnlDaily": 95000,
        "pnlWeekly": 760000,
        "pnlAllTime": 40320000,
        "apr": 0.178,
        "followers": 27650
      }
    ]
  },
  "meta": { "total": 1, "days": 7 }
}

Notes

• APR is decimal (0.185 = 18.5%). Multiply by 100 for UI display.
• If HLP ever re-spawns with a new address, the `name`-keyed lookup continues to work.