Sign in
Historical Data

Get Vault Historical Data

Changed on

Get combined historical time-series (TVL, share price, base APY) for a vault, bucketed by interval over [from, to].

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

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

historyTruncatedboolean

true when backend hit the row cap and oldest APY values may be missing predecessors

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

  • v260527ba59276Revision changes
    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the /// response's property type changed from number to string null for status

    • breaking

      the /// response's property type changed from null number to string null for status

    • breaking

      the /// response's property type changed from number to string null for status

    • breaking

      the /// response's property type changed from null number to string null for status

    • info

      the query request parameter endDate became optional