# Historical (PRO)

Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods.

## GET /v2/historical/{network}/{vaultAddress}

> Retrieves historical APY and TVL for a specific vault, based on the provided query parameters.

```json
{"openapi":"3.0.3","info":{"title":"Vaults.fyi API","version":"2.0.0"},"tags":[{"name":"Historical (PRO)","description":"Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods."}],"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/historical/{network}/{vaultAddress}":{"get":{"tags":["Historical (PRO)"],"description":"Retrieves historical APY and TVL for a specific vault, based on the provided query parameters.","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","enum":["1day","7day","30day"],"default":"7day"},"in":"query","name":"apyInterval","required":false,"description":"Interval for APY data. Possible values: 1day, 7day, 30day"},{"schema":{"type":"string","enum":["1hour","1day","1week"],"default":"1hour"},"in":"query","name":"granularity","required":false,"description":"Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week"},{"schema":{"type":"integer","default":0},"in":"query","name":"fromTimestamp","required":false,"description":"Timestamp for the start of the time period for which data will be fetched"},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Timestamp for the end of the time period for which data will be fetched"},{"schema":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","eip155:1","eip155:10","eip155:42161","eip155:137","eip155:100","eip155:8453","eip155:130","eip155:1923","eip155:42220","eip155:480","eip155:80094","eip155:57073","eip155:56","eip155:999","eip155:9745","eip155:43114","eip155:747474","eip155:59144","eip155:4326","eip155:143","eip155:42793"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"vaultAddress","required":true,"description":"Address of the vault for which the data will be returned"}],"responses":{"200":{"description":"Historical TVL and APY data for a vault, paginated by timestamp","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Timestamp of the data point"},"blockNumber":{"type":"string","description":"Block number of the data point"},"apy":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"APY breakdown"},"tvl":{"type":"object","properties":{"usd":{"type":"string","description":"TVL in USD"},"native":{"type":"string","description":"Native TVL"}},"required":["usd","native"],"additionalProperties":false,"description":"TVL breakdown"},"sharePrice":{"type":"number","description":"Share price of vault"}},"required":["timestamp","blockNumber","apy","tvl","sharePrice"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Historical TVL and APY data for a vault, paginated by timestamp"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["API key required. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance.","This endpoint is only available to vaults.fyi PRO subscribers. Please upgrade your API key to access this feature."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","enum":["base"]},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{}},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","maxAmountRequired","resource","description","mimeType","payTo","maxTimeoutSeconds","asset","extra"],"additionalProperties":false}},{}]}},"required":["x402Version","error"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["The provided API key has exhausted its available credits. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}}}}}}}
```

## GET /v2/historical/{network}/{vaultAddress}/apy

> Retrieves time-series historical APY data for a specific vault, including base yield and rewards components over a customizable time range

```json
{"openapi":"3.0.3","info":{"title":"Vaults.fyi API","version":"2.0.0"},"tags":[{"name":"Historical (PRO)","description":"Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods."}],"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/historical/{network}/{vaultAddress}/apy":{"get":{"tags":["Historical (PRO)"],"description":"Retrieves time-series historical APY data for a specific vault, including base yield and rewards components over a customizable time range","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","enum":["1day","7day","30day"],"default":"7day"},"in":"query","name":"apyInterval","required":false,"description":"Interval for APY data. Possible values: 1day, 7day, 30day"},{"schema":{"type":"string","enum":["1hour","1day","1week"],"default":"1hour"},"in":"query","name":"granularity","required":false,"description":"Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week"},{"schema":{"type":"integer","default":0},"in":"query","name":"fromTimestamp","required":false,"description":"Timestamp for the start of the time period for which data will be fetched"},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Timestamp for the end of the time period for which data will be fetched"},{"schema":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","eip155:1","eip155:10","eip155:42161","eip155:137","eip155:100","eip155:8453","eip155:130","eip155:1923","eip155:42220","eip155:480","eip155:80094","eip155:57073","eip155:56","eip155:999","eip155:9745","eip155:43114","eip155:747474","eip155:59144","eip155:4326","eip155:143","eip155:42793"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"vaultAddress","required":true,"description":"Address of the vault for which the data will be returned"}],"responses":{"200":{"description":"Historical APY data for a vault, paginated by timestamp","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Timestamp of the data point"},"blockNumber":{"type":"string","description":"Block number of the data point"},"apy":{"type":"object","properties":{"base":{"type":"number","description":"Base APY"},"reward":{"type":"number","description":"Reward APY"},"total":{"type":"number","description":"Total APY"}},"required":["base","reward","total"],"additionalProperties":false,"description":"APY breakdown"}},"required":["timestamp","blockNumber","apy"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Historical APY data for a vault, paginated by timestamp"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["API key required. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance.","This endpoint is only available to vaults.fyi PRO subscribers. Please upgrade your API key to access this feature."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","enum":["base"]},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{}},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","maxAmountRequired","resource","description","mimeType","payTo","maxTimeoutSeconds","asset","extra"],"additionalProperties":false}},{}]}},"required":["x402Version","error"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["The provided API key has exhausted its available credits. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}}}}}}}
```

## GET /v2/historical/{network}/{vaultAddress}/tvl

> Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range

```json
{"openapi":"3.0.3","info":{"title":"Vaults.fyi API","version":"2.0.0"},"tags":[{"name":"Historical (PRO)","description":"Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods."}],"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/historical/{network}/{vaultAddress}/tvl":{"get":{"tags":["Historical (PRO)"],"description":"Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","enum":["1day","7day","30day"],"default":"7day"},"in":"query","name":"apyInterval","required":false,"description":"Interval for APY data. Possible values: 1day, 7day, 30day"},{"schema":{"type":"string","enum":["1hour","1day","1week"],"default":"1hour"},"in":"query","name":"granularity","required":false,"description":"Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week"},{"schema":{"type":"integer","default":0},"in":"query","name":"fromTimestamp","required":false,"description":"Timestamp for the start of the time period for which data will be fetched"},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Timestamp for the end of the time period for which data will be fetched"},{"schema":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","eip155:1","eip155:10","eip155:42161","eip155:137","eip155:100","eip155:8453","eip155:130","eip155:1923","eip155:42220","eip155:480","eip155:80094","eip155:57073","eip155:56","eip155:999","eip155:9745","eip155:43114","eip155:747474","eip155:59144","eip155:4326","eip155:143","eip155:42793"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"vaultAddress","required":true,"description":"Address of the vault for which the data will be returned"}],"responses":{"200":{"description":"Historical TVL data for a vault, paginated by timestamp","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Timestamp of the data point"},"blockNumber":{"type":"string","description":"Block number of the data point"},"tvl":{"type":"object","properties":{"usd":{"type":"string","description":"TVL in USD"},"native":{"type":"string","description":"Native TVL"}},"required":["usd","native"],"additionalProperties":false,"description":"TVL breakdown"}},"required":["timestamp","blockNumber","tvl"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Historical TVL data for a vault, paginated by timestamp"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["API key required. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance.","This endpoint is only available to vaults.fyi PRO subscribers. Please upgrade your API key to access this feature."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","enum":["base"]},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{}},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","maxAmountRequired","resource","description","mimeType","payTo","maxTimeoutSeconds","asset","extra"],"additionalProperties":false}},{}]}},"required":["x402Version","error"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["The provided API key has exhausted its available credits. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}}}}}}}
```

## GET /v2/historical/{network}/{vaultAddress}/sharePrice

> Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range

```json
{"openapi":"3.0.3","info":{"title":"Vaults.fyi API","version":"2.0.0"},"tags":[{"name":"Historical (PRO)","description":"Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods."}],"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/historical/{network}/{vaultAddress}/sharePrice":{"get":{"tags":["Historical (PRO)"],"description":"Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","enum":["1day","7day","30day"],"default":"7day"},"in":"query","name":"apyInterval","required":false,"description":"Interval for APY data. Possible values: 1day, 7day, 30day"},{"schema":{"type":"string","enum":["1hour","1day","1week"],"default":"1hour"},"in":"query","name":"granularity","required":false,"description":"Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week"},{"schema":{"type":"integer","default":0},"in":"query","name":"fromTimestamp","required":false,"description":"Timestamp for the start of the time period for which data will be fetched"},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Timestamp for the end of the time period for which data will be fetched"},{"schema":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","eip155:1","eip155:10","eip155:42161","eip155:137","eip155:100","eip155:8453","eip155:130","eip155:1923","eip155:42220","eip155:480","eip155:80094","eip155:57073","eip155:56","eip155:999","eip155:9745","eip155:43114","eip155:747474","eip155:59144","eip155:4326","eip155:143","eip155:42793"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"vaultAddress","required":true,"description":"Address of the vault for which the data will be returned"}],"responses":{"200":{"description":"Historical SharePrice data for a vault, paginated by timestamp","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Timestamp of the data point"},"blockNumber":{"type":"string","description":"Block number of the data point"},"sharePrice":{"type":"number","description":"Share price of vault"}},"required":["timestamp","blockNumber","sharePrice"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Historical SharePrice data for a vault, paginated by timestamp"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["API key required. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance.","This endpoint is only available to vaults.fyi PRO subscribers. Please upgrade your API key to access this feature."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","enum":["base"]},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{}},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","maxAmountRequired","resource","description","mimeType","payTo","maxTimeoutSeconds","asset","extra"],"additionalProperties":false}},{}]}},"required":["x402Version","error"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["The provided API key has exhausted its available credits. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}}}}}}}
```

## GET /v2/historical/asset-prices/{network}/{assetAddress}

> Retrieves historical USD prices for a specific asset on a given network.

```json
{"openapi":"3.0.3","info":{"title":"Vaults.fyi API","version":"2.0.0"},"tags":[{"name":"Historical (PRO)","description":"Premium endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods."}],"servers":[{"url":"https://api.vaults.fyi","description":"Vaults.fyi API"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/historical/asset-prices/{network}/{assetAddress}":{"get":{"tags":["Historical (PRO)"],"description":"Retrieves historical USD prices for a specific asset on a given network.","parameters":[{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"page","required":false,"description":"Page number (starting from 0)"},{"schema":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20000,"default":50},"in":"query","name":"perPage","required":false,"description":"Number of items per page"},{"schema":{"type":"string","enum":["1hour","1day","1week"],"default":"1hour"},"in":"query","name":"granularity","required":false,"description":"Granularity for historical data (even intervals starting from epoch 0). Possible values: 1hour, 1day, 1week"},{"schema":{"type":"integer","default":0},"in":"query","name":"fromTimestamp","required":false,"description":"Timestamp for the start of the time period for which data will be fetched"},{"schema":{"type":"integer"},"in":"query","name":"toTimestamp","required":false,"description":"Timestamp for the end of the time period for which data will be fetched"},{"schema":{"type":"string","enum":["mainnet","optimism","arbitrum","polygon","gnosis","base","unichain","swellchain","celo","worldchain","berachain","ink","bsc","hyperliquid","plasma","avalanche","katana","linea","mega-eth","monad","etherlink","eip155:1","eip155:10","eip155:42161","eip155:137","eip155:100","eip155:8453","eip155:130","eip155:1923","eip155:42220","eip155:480","eip155:80094","eip155:57073","eip155:56","eip155:999","eip155:9745","eip155:43114","eip155:747474","eip155:59144","eip155:4326","eip155:143","eip155:42793"]},"in":"path","name":"network","required":true,"description":"Include only vaults with provided network(name or CAIP)"},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"in":"path","name":"assetAddress","required":true,"description":"Asset address to get the historical prices for"}],"responses":{"200":{"description":"Historical price data for an asset, paginated by timestamp","content":{"application/json":{"schema":{"type":"object","properties":{"itemsOnPage":{"type":"integer","description":"Number of items on the current page"},"nextPage":{"type":"integer","description":"Next page number"},"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Aggregating timestamp of the price data point"},"priceInUsd":{"type":"string","description":"Asset price in USD"}},"required":["timestamp","priceInUsd"],"additionalProperties":false,"description":"Array of items on the current page"}}},"required":["itemsOnPage","data"],"additionalProperties":false,"description":"Historical price data for an asset, paginated by timestamp"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"statusCode":{"type":"number"},"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["statusCode","error","message"],"additionalProperties":false},{}]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string","enum":["API key required. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance.","This endpoint is only available to vaults.fyi PRO subscribers. Please upgrade your API key to access this feature."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"x402Version":{"anyOf":[{"type":"number"},{"type":"string"}]},"error":{"type":"string"},"accepts":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"]},"network":{"type":"string","enum":["base"]},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"outputSchema":{"type":"object","additionalProperties":{}},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"number"},"asset":{"type":"string"},"extra":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","maxAmountRequired","resource","description","mimeType","payTo","maxTimeoutSeconds","asset","extra"],"additionalProperties":false}},{}]}},"required":["x402Version","error"],"additionalProperties":false},{}]}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","enum":["The provided API key has exhausted its available credits. Please contact vaults.fyi support at https://t.me/vaultsfyisupport or email (support@wallfacer.io) for further assistance."]},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false}}}},"408":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"errorId":{"type":"string"}},"additionalProperties":false},{}]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Internal Server Error"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"string","enum":["Service Unavailable"]},"message":{"type":"string"},"errorId":{"type":"string"}},"required":["error","message"],"additionalProperties":false},{}]}}}}}}}}}
```