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

# Get pool statistics

> Returns daily statistics for a specific pool. Data is cached for 60 seconds.



## OpenAPI

````yaml https://gateway.ramses.xyz/v3/hyperevm/swagger/json get /stats/{poolAddress}
openapi: 3.1.0
info:
  title: Ramses API - HyperEVM
  description: |-
    REST API for the Ramses DEX on HyperEVM.

    ## Rate Limiting

    - **30 requests per 30 seconds** per client IP address

    ## Caching

    Some endpoints are cached to improve performance:
    - `/stats`: 60 seconds
    - `/protocol-info`: 30 seconds
    - `/hyperram-data`: 30 seconds
    - `/circ_supply`, `/fdv`, `/hyperram_fdv`: 5 minutes
  version: 4.0.0
  contact:
    name: Ramses
    url: https://gateway.ramses.xyz/v3/hyperevm
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://gateway.ramses.xyz/v3/hyperevm
    description: Production
security: []
tags:
  - name: Health
    description: API and indexer health status
  - name: Pools
    description: Liquidity pool data, TVL, APRs, and rewards
  - name: Tokens
    description: Token information and prices
  - name: Stats
    description: Historical protocol and pool statistics
  - name: Protocol
    description: Protocol-wide token supply, emissions, and voting metrics
  - name: Positions
    description: User position data
  - name: HyperRAM
    description: X33 token compound/rebase data and APR calculations
  - name: CoinGecko
    description: Endpoints for CoinGecko integration (supply data)
  - name: Fee Launcher
    description: Dynamic fee schedules for new pool launches
paths:
  /stats/{poolAddress}:
    get:
      tags:
        - Stats
      summary: Get pool statistics
      description: >-
        Returns daily statistics for a specific pool. Data is cached for 60
        seconds.
      operationId: getStatsByPoolAddress
      parameters:
        - name: poolAddress
          in: path
          required: true
          schema:
            pattern: ^0x[a-fA-F0-9]{40}$
            description: Ethereum address (0x-prefixed, 40 hex characters)
            examples:
              - '0x555570a286F15EbDFE42B66eDE2f724Aa1AB5555'
            type: string
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: array
                items:
                  description: Pool daily statistics
                  examples:
                    - startOfDay: 1709510400
                      feesUSD: '1234.56'
                      volumeUSD: '123456.78'
                      tvlUSD: '1234567.89'
                  type: object
                  properties:
                    startOfDay:
                      description: Unix timestamp of day start
                      type: number
                    feesUSD:
                      description: Fees in USD
                      type: string
                    volumeUSD:
                      description: Volume in USD
                      type: string
                    tvlUSD:
                      description: TVL in USD
                      type: string
                    volumeToken0:
                      description: Volume in token0 (CL only)
                      type: string
                    volumeToken1:
                      description: Volume in token1 (CL only)
                      type: string
                    liquidity:
                      description: Liquidity (CL only)
                      type: string
                    high:
                      description: High price (CL only)
                      type: string
                    low:
                      description: Low price (CL only)
                      type: string
                  required:
                    - startOfDay
                    - feesUSD
                    - volumeUSD
                    - tvlUSD

````