Sign in
Historical Data

Get Vault Historical TVL

Changed on

Get historical TVL time-series for a vault over [from, to]. Values are the time-weighted average over each bucket. USD comes from deposit_metrics. Native is denominated in the vault's underlying base asset and is null, together with blockNumber, when no share price matches the bucket. Missing share prices do not suppress USD TVL points. Step is rounded up to a 15-minute grain and the series is never zero-filled. The first and last buckets may cover a partial step when step does not divide the aligned range.

get/v2/opportunities/{chainId}/{vaultAddress}/historical/tvl

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

chainIdinteger required

EVM chain ID (e.g. 1 for Ethereum)

vaultAddressstring required

0x-prefixed 40-hex vault contract address

Query parameters

stepinteger

Point spacing (granularity) in seconds, at most 31536000 (365 days). Defaults to 86400 (1 day). The range may span at most 10,000 buckets at this step

apyIntervalinteger

APY/APR trailing window (lookback) in seconds, independent of step, at most 7776000 (90 days). Defaults to 2592000 (30 days)

startDatestring date-time required

Inclusive lower bound (RFC3339/ISO-8601). At most 365 days before now

endDatestring date-time

Inclusive upper bound (RFC3339/ISO-8601). Omit it — or send a future instant — to mean "the latest data available"; clients that want a live trailing series should do that rather than sending a client clock, so the query key stays stable while the answer keeps moving.

Response

OK

Changes

  • v28a7a742fa9bdRevision changes
    • warning

      for the query request parameter apyInterval, the max was set to 7776000.00

    • warning

      for the query request parameter step, the max was set to 31536000.00

  • v252e1390e203aRevision changes
    • breaking

      the response property // became nullable for the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status