Tokens

REST APIs for tokens on SaucerSwap

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

Get compact token data

GET/tokens

Response

200

Successful response

Body

application/json

id*string

Example: "0.0.731861"

icon*string

Example: "/images/tokens/sauce.svg"

symbol*string

Example: "SAUCE"

decimals*integer

Example: 6

price*string

Example: "36806544"

priceUsd*number (float)

Example: 0.01760954

dueDiligenceComplete*boolean

Example: true

isFeeOnTransferToken*boolean

Example: false

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "id": "0.0.731861",
    "icon": "/images/tokens/sauce.svg",
    "symbol": "SAUCE",
    "decimals": 6,
    "price": "36806544",
    "priceUsd": 0.01760954,
    "dueDiligenceComplete": true,
    "isFeeOnTransferToken": false
  }
]

Get detailed token data

GET/tokens/full

Response

200

Successful response

Body

application/json

id*string

Example: "0.0.731861"

name*string

Example: "SAUCE"

symbol*string

Example: "SAUCE"

icon*string

Example: "/images/tokens/sauce.svg"

decimals*integer

Example: 6

price*string

Example: "36806544"

priceUsd*number

Example: 0.01763457

dueDiligenceComplete*boolean

Example: true

isFeeOnTransferToken*boolean

Example: false

descriptionstring

Example: "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera."

websitestring

Example: "https://www.saucerswap.finance/"

sentinelReportstring

Example: "https://sentinel.headstarter.org/details/saucerswap"

twitterHandlestring

Example: "SaucerSwapLabs"

timestampSecondsLastListingChange*integer

Example: 0

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "id": "0.0.731861",
    "name": "SAUCE",
    "symbol": "SAUCE",
    "icon": "/images/tokens/sauce.svg",
    "decimals": 6,
    "price": "36806544",
    "priceUsd": 0.01763457,
    "dueDiligenceComplete": true,
    "isFeeOnTransferToken": false,
    "description": "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera.",
    "website": "https://www.saucerswap.finance/",
    "sentinelReport": "https://sentinel.headstarter.org/details/saucerswap",
    "twitterHandle": "SaucerSwapLabs",
    "timestampSecondsLastListingChange": 0
  }
]

Get detailed token data by id

GET/tokens/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

id*string

Example: "0.0.731861"

name*string

Example: "SAUCE"

symbol*string

Example: "SAUCE"

icon*string

Example: "/images/tokens/sauce.svg"

decimals*integer

Example: 6

price*string

Example: "36806544"

priceUsd*number

Example: 0.01763457

dueDiligenceComplete*boolean

Example: true

isFeeOnTransferToken*boolean

Example: false

descriptionstring

Example: "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera."

websitestring

Example: "https://www.saucerswap.finance/"

sentinelReportstring

Example: "https://sentinel.headstarter.org/details/saucerswap"

twitterHandlestring

Example: "SaucerSwapLabs"

timestampSecondsLastListingChange*integer

Example: 0

Request

JavaScriptCurlPython

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

Response

200

{
  "id": "0.0.731861",
  "name": "SAUCE",
  "symbol": "SAUCE",
  "icon": "/images/tokens/sauce.svg",
  "decimals": 6,
  "price": "36806544",
  "priceUsd": 0.01763457,
  "dueDiligenceComplete": true,
  "isFeeOnTransferToken": false,
  "description": "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera.",
  "website": "https://www.saucerswap.finance/",
  "sentinelReport": "https://sentinel.headstarter.org/details/saucerswap",
  "twitterHandle": "SaucerSwapLabs",
  "timestampSecondsLastListingChange": 0
}

Get default listed token data

GET/tokens/known

Response

200

Successful response

Body

application/json

id*string

Example: "0.0.731861"

name*string

Example: "SAUCE"

symbol*string

Example: "SAUCE"

icon*string

Example: "/images/tokens/sauce.svg"

decimals*integer

Example: 6

price*string

Example: "36806544"

priceUsd*number

Example: 0.01763457

dueDiligenceComplete*boolean

Example: true

isFeeOnTransferToken*boolean

Example: false

descriptionstring

Example: "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera."

websitestring

Example: "https://www.saucerswap.finance/"

sentinelReportstring

Example: "https://sentinel.headstarter.org/details/saucerswap"

twitterHandlestring

Example: "SaucerSwapLabs"

timestampSecondsLastListingChange*integer

Example: 0

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "id": "0.0.731861",
    "name": "SAUCE",
    "symbol": "SAUCE",
    "icon": "/images/tokens/sauce.svg",
    "decimals": 6,
    "price": "36806544",
    "priceUsd": 0.01763457,
    "dueDiligenceComplete": true,
    "isFeeOnTransferToken": false,
    "description": "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera.",
    "website": "https://www.saucerswap.finance/",
    "sentinelReport": "https://sentinel.headstarter.org/details/saucerswap",
    "twitterHandle": "SaucerSwapLabs",
    "timestampSecondsLastListingChange": 0
  }
]

Get hourly, daily and weekly price change for default listed tokens

GET/tokens/default

Response

200

Successful response

Body

application/json

id*string

Example: "0.0.731861"

symbol*string

Example: "SAUCE"

priceUsd*number (float)

Example: 0.0177

liquidityUsd*number (float)

Example: 2880053.73

priceChangeHour*number (float)

Example: 0.01

priceChangeDay*number (float)

Example: 0.04

priceChangeWeek*number (float)

Example: 0.11

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "id": "0.0.731861",
    "symbol": "SAUCE",
    "priceUsd": 0.0177,
    "liquidityUsd": 2880053.73,
    "priceChangeHour": 0.01,
    "priceChangeDay": 0.04,
    "priceChangeWeek": 0.11
  }
]

Get a mapping of tokenId to 24-hours price change percentage

GET/tokens/price-change

Response

200

Successful operation

Body

application/json

Other propertiesnumber

24-hours price change percentage for the given tokenId

Request

JavaScriptCurlPython

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

Response

200

{
  "0.0.731861": -2.5351798847046836,
  "0.0.786931": 4.047875243039449,
  "0.0.629591": -12.223518441429796
}

Get daily price, volume and liquidity for all tokens

GET/tokens/daily

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get weekly price, volume and liquidity for all tokens

GET/tokens/weekly

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get monthly price, volume and liquidity for all tokens

GET/tokens/monthly

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get yearly price, volume and liquidity for all tokens

GET/tokens/yearly

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get daily price, volume and liquidity for token by id

GET/tokens/daily/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get weekly price, volume and liquidity for token by id

GET/tokens/weekly/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get monthly price, volume and liquidity for token by id

GET/tokens/monthly/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get yearly price, volume and liquidity for token by id

GET/tokens/yearly/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

timestampSeconds*integer

Unix seconds

Example: 1697677200

tokenId*string

Token ID

Example: "0.0.731861"

price*string

Example: "36334886"

liquidity*string

Token liquidity in its smallest unit

Example: "5971792596548121"

volume*string

Token volume in its smallest unit

Example: "100169644699152"

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "timestampSeconds": 1697677200,
    "tokenId": "0.0.731861",
    "price": "36334886",
    "liquidity": "5971792596548121",
    "volume": "100169644699152"
  }
]

Get associated pools containing the token by id

GET/tokens/associated-pools/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Response

200

Successful response

Body

application/json

id*integer

Example: 213

contractId*string

Example: "0.0.1465865"

lpToken*LPToken (all of)

lpTokenReserve*string

LP token reserve in its smallest unit

Example: "23490447137584"

tokenA*TokenA (all of)

tokenReserveA*string

Token A reserve in its smallest unit

Example: "25185652046087"

tokenB*TokenB (all of)

tokenReserveB*string

Token B reserve in its smallest unit

Example: "22634187941347"

Request

JavaScriptCurlPython

const response = await fetch('/tokens/associated-pools/{tokenId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 213,
    "contractId": "0.0.1465865",
    "lpToken": {
      "id": "0.0.1465866",
      "name": "SS-LP SAUCE - XSAUCE",
      "symbol": "SAUCE - XSAUCE",
      "decimals": 8,
      "priceUsd": 3.7760690082569948
    },
    "lpTokenReserve": "23490447137584",
    "tokenA": {
      "id": "0.0.731861",
      "name": "SAUCE",
      "symbol": "SAUCE",
      "decimals": 6,
      "priceUsd": 0.01760954,
      "description": "<p>SaucerSwap is an open source and non-custodial AMM protocol native to Hedera.</p>",
      "website": "https://www.saucerswap.finance/",
      "sentinelReport": "https://sentinel.headstarter.org/details/saucerswap",
      "twitterHandle": "SaucerSwapLabs",
      "timestampSecondsLastListingChange": 0,
      "__$markdownParsed": true
    },
    "tokenReserveA": "25185652046087",
    "tokenB": {
      "id": "0.0.1460200",
      "name": "xSAUCE",
      "symbol": "XSAUCE",
      "decimals": 6,
      "priceUsd": 0.01959459,
      "description": "<p>SaucerSwap is an open source and non-custodial AMM protocol native to Hedera.</p>",
      "website": "https://www.saucerswap.finance/",
      "sentinelReport": "https://sentinel.headstarter.org/details/saucerswap",
      "twitterHandle": "SaucerSwapLabs",
      "timestampSecondsLastListingChange": 0,
      "__$markdownParsed": true
    },
    "tokenReserveB": "22634187941347"
  }
]

Get historical candlestick data for token by id

GET/tokens/prices/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Query parameters

Response

200

Successful response

Body

application/json

id*integer

Example: 83

tokenId*string

Example: "0.0.731861"

open*integer

Example: 36358807

openUsd*number (float)

Example: 0.017246927356274498

high*integer

Example: 36370090

highUsd*number (float)

Example: 0.017248478665373164

low*integer

Example: 36334867

lowUsd*number (float)

Example: 0.0169388611613325

close*integer

Example: 36353193

closeUsd*number (float)

Example: 0.0169388611613325

avg*number (float)

Example: 36347000.92028988

avgUsd*number (float)

Example: 0.017085609229304164

volume*string

Example: "4484168318250"

liquidity*string

Example: "5976854242691456"

volumeUsd*number (float)

Example: 2110.33

liquidityUsd*any

Example: 2784930.18

timestampSeconds*integer

Example: 1697681880

startTimestampSeconds*integer

Example: 1697673600

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "id": 83,
    "tokenId": "0.0.731861",
    "open": 36358807,
    "openUsd": 0.017246927356274498,
    "high": 36370090,
    "highUsd": 0.017248478665373164,
    "low": 36334867,
    "lowUsd": 0.0169388611613325,
    "close": 36353193,
    "closeUsd": 0.0169388611613325,
    "avg": 36347000.92028988,
    "avgUsd": 0.017085609229304164,
    "volume": "4484168318250",
    "liquidity": "5976854242691456",
    "volumeUsd": 2110.33,
    "liquidityUsd": 2784930.18,
    "timestampSeconds": 1697681880,
    "startTimestampSeconds": 1697673600
  }
]

Get the latest candlestick data for token by id

GET/tokens/prices/latest/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Query parameters

Response

200

Successful response

Body

application/json

id*integer

Example: 83

tokenId*string

Example: "0.0.731861"

open*integer

Example: 36358807

openUsd*number (float)

Example: 0.017246927356274498

high*integer

Example: 36370090

highUsd*number (float)

Example: 0.017248478665373164

low*integer

Example: 36334867

lowUsd*number (float)

Example: 0.0169388611613325

close*integer

Example: 36353193

closeUsd*number (float)

Example: 0.0169388611613325

avg*number (float)

Example: 36347000.92028988

avgUsd*number (float)

Example: 0.017085609229304164

volume*string

Example: "4484168318250"

liquidity*string

Example: "5976854242691456"

volumeUsd*number (float)

Example: 2110.33

liquidityUsd*any

Example: 2784930.18

timestampSeconds*integer

Example: 1697681880

startTimestampSeconds*integer

Example: 1697673600

Request

JavaScriptCurlPython

const response = await fetch('/tokens/prices/latest/{tokenId}?interval=HOUR', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 83,
    "tokenId": "0.0.731861",
    "open": 36358807,
    "openUsd": 0.017246927356274498,
    "high": 36370090,
    "highUsd": 0.017248478665373164,
    "low": 36334867,
    "lowUsd": 0.0169388611613325,
    "close": 36353193,
    "closeUsd": 0.0169388611613325,
    "avg": 36347000.92028988,
    "avgUsd": 0.017085609229304164,
    "volume": "4484168318250",
    "liquidity": "5976854242691456",
    "volumeUsd": 2110.33,
    "liquidityUsd": 2784930.18,
    "timestampSeconds": 1697681880,
    "startTimestampSeconds": 1697673600
  }
]

Get USD price history for a token by id

GET/tokens/prices/usd/{tokenId}

Path parameters

tokenId*string

Example: "0.0.731861"

Query parameters

Response

200

Successful response

Body

application/json

priceUsdnumber (float)

Example: 0.017734458589574

timestampSecondsinteger

Example: 1697601600

Request

JavaScriptCurlPython

const response = await fetch('/tokens/prices/usd/{tokenId}?from=1697600000&to=1697610000&interval=HOUR', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "priceUsd": 0.017734458589574,
    "timestampSeconds": 1697601600
  }
]