Skip to main content
GET
Get vault history by slug
Returns historical metrics for the logical vault identified by its slug: meta.resolved_vault_id identifies the primary supplying the deployment-local metrics. Rates and share prices are not summed or averaged. The /primary/timeseries endpoint still returns only primary-deployment data, including tvl.native. The logical-vault endpoint exposes USD TVL only because linked deployments can use different numeraires. Snapshots are aligned by timestamp, with the same date range, granularity, ordering, and cursor parameters as deployment history. A missing primary snapshot makes its APY and price null at that timestamp; another deployment’s metrics are never substituted. A missing USD price does not hide otherwise available supply or primary metrics. Before a deployment’s indexed creation time, it contributes zero to TVL. After creation, a missing snapshot or USD price makes the aggregate tvl.usd null; clients should render a gap rather than zero or a partial sum. Supply follows the same inception and snapshot-gap rules, but does not depend on USD prices. Missing supply makes total_supply null. Linked share-issuing deployments must represent the same logical share asset. The current cross-chain groups (gtusda, stgusda, and devusda2) use Aspen multichain pricing with summed share supply. Values are not carried forward. Missing deployment metadata fails the request. Membership and primary selection follow the current Admin registry. This sums deployment TVLs; it does not reproduce the old Aera API’s separate asset-position valuation or include pending deposits held in provisioners.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

slug
string
required

Admin-curated public vault slug

Query Parameters

start
string

Window start: ISO 8601 date or RFC 3339 timestamp.

end
string

Window end: ISO 8601 date or RFC 3339 timestamp.

next
string

Opaque cursor from previous meta.next_cursor.

limit
integer<int64>

Page size (1–10000, default 1000).

order
string

Sort direction: asc (default) or desc.

granularity
string

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

Response

Aggregate USD TVL and share supply with primary deployment metrics

data
object[]
required
meta
object
required