> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# get_apy_by_time_range

> Returns APY information for a specific token mint within a given time range



## OpenAPI

````yaml /api-reference/dynamic-vault/openapi.json get /apy_filter/{token_mint}/{start_timestamp}/{end_timestamp}
openapi: 3.0.3
info:
  title: Vault Keeper API
  description: >-
    API for Vault Keeper - A DeFi vault management system that monitors and
    optimizes vault strategies across multiple protocols
  version: 0.6.0
  contact:
    name: Vault Keeper API Support
servers:
  - url: https://merv2-api.meteora.ag
    description: Mercuria Mainnet API
security: []
tags:
  - name: System
    description: System information and health endpoints
  - name: Vaults
    description: Vault state and information endpoints
  - name: APY
    description: Annual Percentage Yield calculations and historical data
  - name: Virtual Price
    description: Virtual price tracking for vault strategies
paths:
  /apy_filter/{token_mint}/{start_timestamp}/{end_timestamp}:
    get:
      tags:
        - APY
      summary: get_apy_by_time_range
      description: >-
        Returns APY information for a specific token mint within a given time
        range
      operationId: getFilterApyByTimeRange
      parameters:
        - name: token_mint
          in: path
          required: true
          description: The token mint address (Solana public key)
          schema:
            type: string
            pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        - name: start_timestamp
          in: path
          required: true
          description: Start timestamp (Unix timestamp in seconds)
          schema:
            type: string
            pattern: ^[0-9]+$
            example: '1640995200'
        - name: end_timestamp
          in: path
          required: true
          description: >-
            End timestamp (Unix timestamp in seconds). Must be greater than
            start_timestamp
          schema:
            type: string
            pattern: ^[0-9]+$
            example: '1641081600'
      responses:
        '200':
          description: Filtered APY state information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApyState'
        '400':
          description: Bad request - invalid parameters or start timestamp >= end timestamp
          content:
            text/plain:
              schema:
                type: string
                example: 'Error: start timestamp cannot be smaller than end timestamp'
components:
  schemas:
    ApyState:
      type: object
      description: APY state information for different time periods
      properties:
        closest_apy:
          type: array
          description: Most recent APY calculations for each strategy
          items:
            $ref: '#/components/schemas/ProtocolApy'
        average_apy:
          type: array
          description: Moving average APY calculations for each strategy
          items:
            $ref: '#/components/schemas/ProtocolApy'
        long_apy:
          type: array
          description: Long-term APY calculations for each strategy
          items:
            $ref: '#/components/schemas/ProtocolApy'
      required:
        - closest_apy
        - average_apy
        - long_apy
    ProtocolApy:
      type: object
      description: APY information for a specific protocol strategy
      properties:
        strategy_name:
          type: string
          description: Human-readable strategy name
          example: Solend USDC Main Pool
        strategy:
          type: string
          description: Strategy address
          example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
        apy:
          type: number
          format: double
          description: APY percentage (e.g., 5.0 for 5%)
          example: 5
      required:
        - strategy_name
        - strategy
        - apy

````