Skip to main content
GET
/
v2
/
pools
/
{poolId}
Get detailed data for a SaucerSwap V2 pool by id
curl --request GET \
  --url https://api.saucerswap.finance/v2/pools/{poolId} \
  --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,
    "description": "USDC is a fully collateralized U.S. dollar stablecoin. USDC is the bridge between dollars and trading on cryptocurrency exchanges...",
    "website": "https://www.circle.com/en/usdc-multichain/hedera",
    "twitterHandle": "circle"
  },
  "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,
    "description": "USDC is a fully collateralized U.S. dollar stablecoin...",
    "website": "https://www.circle.com/en/usdc-multichain/ethereum",
    "twitterHandle": "circle"
  },
  "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.

Path Parameters

​
poolId
integer
required

Saucerswap pool id

Example:

1

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,
  "description": "USDC is a fully collateralized U.S. dollar stablecoin. USDC is the bridge between dollars and trading on cryptocurrency exchanges...",
  "website": "https://www.circle.com/en/usdc-multichain/hedera",
  "twitterHandle": "circle"
}
​
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,
  "description": "USDC is a fully collateralized U.S. dollar stablecoin...",
  "website": "https://www.circle.com/en/usdc-multichain/ethereum",
  "twitterHandle": "circle"
}
​
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"