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

# REST API: General statistics

> Retrieve protocol-wide SaucerSwap statistics in one call: circulating SAUCE supply, total swap count, TVL in tinybar and USD, and all-time volume.



## OpenAPI

````yaml GET /stats
openapi: 3.0.4
info:
  title: SaucerSwap REST API
  version: 1.0.0
servers:
  - url: https://api.saucerswap.finance
    description: Mainnet
  - url: https://test-api.saucerswap.finance
    description: Testnet
security:
  - ApiKeyAuth: []
paths:
  /stats:
    get:
      tags:
        - Stats
      summary: General statistics
      parameters:
        - $ref: '#/components/parameters/ApiKeyParam'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  circulatingSauce:
                    type: string
                    example: '526531284317600'
                    description: Total sauce in circulation in its smallest unit
                  swapTotal:
                    type: integer
                    example: '1600796'
                    description: Total swaps across all pools since inception
                  tvl:
                    type: string
                    example: '55577479377624950'
                    description: Total value locked priced in Tinybar
                  tvlUsd:
                    type: number
                    format: float
                    example: 26773811.729033
                    description: Total value locked in USD
                  volumeTotal:
                    type: string
                    example: '372768795310667371'
                    description: Total trading volume since inception priced in Tinybar
                  volumeTotalUsd:
                    type: number
                    format: float
                    example: 220524200.282553
                    description: Total volume in USD
components:
  parameters:
    ApiKeyParam:
      name: x-api-key
      in: header
      required: true
      schema:
        type: string
        example: YOUR_API_KEY
      description: >-
        API key for authentication. Request a key from
        support@saucerswap.finance.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key provisioned by the SaucerSwap team. Request one from
        support@saucerswap.finance and send it in the x-api-key header with
        every request.

````