Vaults

Get vault history by slug

Changed on

Returns USD TVL and outstanding share supply summed across every currently linked deployment of an enabled logical vault, including hidden vaults. Uses UTC-aligned snapshots and timestamp pagination. A deployment contributes zero before its indexed creation time; after creation, missing snapshots or USD prices produce null TVL, never a partial sum. Does not carry values forward. Missing supply or a missing snapshot after deployment creation produces null total_supply, independent of USD price availability. APY and unit_price come from the Admin-selected primary deployment at the same timestamp, identified by meta.resolved_vault_id. Missing primary snapshots yield null primary metrics; APY respects Admin visibility. TVL is USD-only because deployment numeraires may differ; native TVL remains available on the primary/per-deployment endpoints. This is a sum of deployment TVLs, not the legacy asset-position valuation. Unknown or disabled slugs return 404; incomplete deployment metadata returns 503.

get/v1/vaults/slug/{slug}/timeseries

Request

  • Base URL: https://api.gauntlet.xyz
  • URL: https://api.gauntlet.xyz/v1/vaults/slug/{slug}/timeseries
  • Auth: none declared

Path parameters

slugstring required

Admin-curated public vault slug

Query parameters

startstring

Window start: ISO 8601 date or RFC 3339 timestamp.

endstring

Window end: ISO 8601 date or RFC 3339 timestamp.

nextstring

Opaque cursor from previous meta.next_cursor.

limitinteger

Page size (1–10000, default 1000).

orderstring

Sort direction: asc (default) or desc.

granularitystring

Sampling granularity: day (default), hour, week, or month.

Response

Aggregate USD TVL and share supply with primary deployment metrics

Changes