Skip to main content
GET
/
v2
/
pools
Get compact data for all SaucerSwap V2 pools
curl --request GET \
  --url https://api.saucerswap.finance/v2/pools \
  --header 'x-api-key: <x-api-key>'
[
  {
    "id": 1,
    "contractId": "0.0.3948521",
    "tokenA": {
      "decimals": 6,
      "icon": "/images/tokens/usdc.png",
      "id": "0.0.456858",
      "name": "USD Coin",
      "price": "1678944894",
      "priceUsd": 1.00375771,
      "symbol": "USDC",
      "dueDiligenceComplete": true,
      "isFeeOnTransferToken": false
    },
    "tokenB": {
      "decimals": 6,
      "icon": "/images/tokens/usdc.png",
      "id": "0.0.1055459",
      "name": "USD Coin",
      "price": "1681384187",
      "priceUsd": 1.00521604,
      "symbol": "USDC[hts]",
      "dueDiligenceComplete": true,
      "isFeeOnTransferToken": false
    },
    "amountA": "6313040",
    "amountB": "6313042",
    "fee": 500,
    "sqrtRatioX96": "79228162514992909706099547250",
    "tickCurrent": 0,
    "liquidity": "10878982596"
  }
]
Hedera NetworkBase URL
Mainnethttps://api.saucerswap.finance
Testnethttps://test-api.saucerswap.finance
PreviewnetNot supported

Headers

​
x-api-key
string
default:875e1017-87b8-4b12-8301-6aa1f1aa073b
required

API key for authentication. The demo api key provided is globally rate limited. Do not use in production.

Response

200 - application/json

Successful response

​
id
integer
required

Pool id

Example:

1

​
contractId
string
required

Contract id (shard.realm.num)

Example:

"0.0.3948521"

​
tokenA
object
required
Example:
{
  "decimals": 6,
  "icon": "/images/tokens/usdc.png",
  "id": "0.0.456858",
  "name": "USD Coin",
  "price": "1678944894",
  "priceUsd": 1.00375771,
  "symbol": "USDC",
  "dueDiligenceComplete": true,
  "isFeeOnTransferToken": false
}
​
tokenB
object
required
Example:
{
  "decimals": 6,
  "icon": "/images/tokens/usdc.png",
  "id": "0.0.1055459",
  "name": "USD Coin",
  "price": "1681384187",
  "priceUsd": 1.00521604,
  "symbol": "USDC[hts]",
  "dueDiligenceComplete": true,
  "isFeeOnTransferToken": false
}
​
amountA
string
required

Total amount for token A

Example:

"6313040"

​
amountB
string
required

Total amount for token B

Example:

"6313042"

​
fee
integer
required

Swap fee tier for the pool, denoted in basis points

Example:

500

​
sqrtRatioX96
string
required

Encoded square root of price ratio between tokens in the pool as a Q64.96 number

Example:

"79228162514992909706099547250"

​
tickCurrent
integer
required

Current active tick index, representing a specific price point in the pool

Example:

0

​
liquidity
string
required

Total liquidity for the pool

Example:

"10878982596"