Stats

REST APIs for SaucerSwap statistics.

Access the SaucerSwap API using the following base URLs for testnet and mainnet environments:

Hedera Network	Base URL
Mainnet	https://api.saucerswap.finance/
Testnet	https://test-api.saucerswap.finance/
Previewnet	Not supported

General statistics

GET/stats

Response

200

Successful response

Body

application/json

circulatingSaucestring

Total sauce in circulation in its smallest unit

Example: "526531284317600"

swapTotalinteger

Total swaps across all pools since inception

Example: "1600796"

tvlstring

Total value locked priced in Tinybar

Example: "55577479377624950"

tvlUsdnumber (float)

Total value locked in USD

Example: 26773811.729033

volumeTotalstring

Total trading volume since inception priced in Tinybar

Example: "372768795310667371"

volumeTotalUsdnumber (float)

Total volume in USD

Example: 220524200.282553

Request

JavaScriptCurlPython

const response = await fetch('/stats', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "circulatingSauce": "526531284317600",
  "swapTotal": "1600796",
  "tvl": "55577479377624950",
  "tvlUsd": 26773811.729033,
  "volumeTotal": "372768795310667371",
  "volumeTotalUsd": 220524200.282553
}

Single-Sided Staking statistics

GET/stats/sss

Response

200

Successful response

Body

application/json

avg5daynumber (float)

5-day average APR

Example: 0.0462

idinteger

Example: 146206

rationumber (float)

XSAUCE to SAUCE ratio

Example: 1.1172

saucestring

SAUCE amount in its smallest unit

Example: "242601707456381"

timestampSecondsinteger

Unix timestamp in seconds

Example: "1697616900"

xsaucestring

XSAUCE amount in its smallest unit

Example: "217150119725425"

Request

JavaScriptCurlPython

const response = await fetch('/stats/sss', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "avg5day": 0.0462,
  "id": 146206,
  "ratio": 1.1172,
  "sauce": "242601707456381",
  "timestampSeconds": "1697616900",
  "xsauce": "217150119725425"
}

Get historical HBAR price data (minutely)

GET/stats/hbarHistoricalPrices

Query parameters

Response

200

Successful response

Body

application/json

idinteger

Example: 548294

priceUsdnumber

Example: 0.04830379666666667

timestampSecondsinteger

Example: 1697599980

Request

JavaScriptCurlPython

const response = await fetch('/stats/hbarHistoricalPrices?from=1697600000&to=1697610000', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 548294,
    "priceUsd": 0.04830379666666667,
    "timestampSeconds": 1697599980
  }
]

Get platform historical liquidity or volume data

GET/stats/platformData

Query parameters

Response

200

Successful response

Body

application/json

valueHbarstring

value in Tinybar

Example: 46701854905030720

timestampSecondsinteger

Example: 1697598000

Request

JavaScriptCurlPython

const response = await fetch('/stats/platformData?from=1697600000&to=1697610000&interval=HOUR&field=LIQUIDITY', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "valueHbar": 46701854905030720,
    "timestampSeconds": 1697598000
  }
]