> ## Documentation Index > Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt > Use this file to discover all available pages before exploring further. # Get historical APY > Retrieves time-series historical APY data for a specific vault, including base yield and rewards components over a customizable time range ## OpenAPI ````yaml https://api.vaults.fyi/v2/documentation/json get /v2/historical/{network}/{vaultId}/apy openapi: 3.0.3 info: title: Vaults.fyi API version: 2.0.0 description: >- The Vaults.fyi V2 API offers a streamlined, better structured, and more performant interface for accessing DeFi vault data. This simplified version delivers optimized performance while maintaining comprehensive coverage across networks. Basic API key use is limited to 10 requests per minute. servers: - url: https://api.vaults.fyi description: Vaults.fyi API security: [] tags: - name: General description: >- Core informational endpoints providing essential reference data such as networks, assets, and vaults listings for orientation and exploration. - name: Detailed Vaults description: >- Comprehensive vault data endpoints delivering in-depth analytics including APY metrics, TVL statistics, rewards breakdowns, and risk scores. - name: Benchmarks description: >- Vaults.fyi curated benchmark endpoints providing aggregated yield performance data for USD and ETH denominated assets across selected networks. - name: Historical description: >- Endpoints returning time-series historical data for vault metrics, enabling trend analysis and performance tracking over customizable periods. - name: Portfolio description: >- Advanced endpoints providing detailed information about user balances, active positions, historical interactions, and tailored investment opportunities. - name: Transactions description: >- Endpoints for executing vault deposits, withdrawals, and reward claims with ready-to-sign transaction payloads. - name: NRT description: >- NRT (Near-Real-Time) endpoints return live vault data updated continuously throughout the day, including current share price, total supply, TVL, and APY. - name: Health paths: /v2/historical/{network}/{vaultId}/apy: get: tags: - Historical summary: Get historical APY description: >- Retrieves time-series historical APY data for a specific vault, including base yield and rewards components over a customizable time range operationId: getHistoricalApy 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 in: path name: vaultId required: true description: Vault id 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: - >- An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments. 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 resource: type: object properties: url: type: string description: type: string mimeType: type: string serviceName: type: string tags: type: array items: type: string iconUrl: type: string required: - url additionalProperties: false accepts: anyOf: - type: array items: type: object properties: scheme: type: string enum: - exact network: type: string amount: type: string 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 - amount - payTo - maxTimeoutSeconds - asset additionalProperties: false - {} extensions: type: object additionalProperties: {} required: - x402Version - resource additionalProperties: false - {} '403': description: Default Response content: application/json: schema: anyOf: - type: object properties: error: type: string enum: - Forbidden message: type: string enum: - >- This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits 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 - {} '422': description: Default Response content: application/json: schema: anyOf: - type: object properties: statusCode: type: number error: type: string enum: - Unprocessable Entity message: type: string errorId: type: string required: - statusCode - error - message 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: statusCode: type: number error: type: string enum: - Service Unavailable message: type: string errorId: type: string required: - statusCode - error - message additionalProperties: false - {} security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````