Sign in

v1

latestOpenAPI 3.0.42026-07-26432241.7 KB
SaucerSwap V2

Get all liquidity positions by account id

get/v2/nfts/{accountId}/positions

Path parameters

accountIdstring required
Example:0.0.12345

Hedera account id (shard.realm.num)

Headers

x-api-keystring required

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

Response

Successful response

tokenSNinteger required

NFT serial number representing user's position

accountIdstring required

Hedera account id (shard.realm.num)

deletedboolean required

True if this position was deleted otherwise false

createdAtstring required

Unix timestamp when this position was created

updatedAtstring required

Unix timestamp when this position was updated

feeinteger required

Swap fee tier denoted in basis points

tickUpperinteger required

Upper end of the position's price range

tickLowerinteger required

Lower end of the position's price range

liquiditystring required

The amount of liquidity provided by the position

feeGrowthInside0LastX128string required

Accumulated fee growth for token0 inside the tick range since the last time liquidity was added or removed

feeGrowthInside1LastX128string required

Accumulated fee growth for token1 inside the tick range since the last time liquidity was added or removed

tokensOwed0string required

Total amount of token0 owed to the position due to fees generated from swaps within the position's price range

tokensOwed1string required

Total amount of token1 owed to the position due to fees generated from swaps within the position's price range

Example response

[
  {
    "tokenSN": 160,
    "accountId": "0.0.12345",
    "createdAt": "1697779560.762467685",
    "updatedAt": "1698287867.747005303",
    "token0": {
      "id": "0.0.731861",
      "name": "SAUCE",
      "symbol": "SAUCE",
      "icon": "/images/tokens/sauce.svg",
      "decimals": 6,
      "price": "36806544",
      "priceUsd": 0.01763457,
      "dueDiligenceComplete": true,
      "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"
    },
    "token1": {
      "id": "0.0.731861",
      "name": "SAUCE",
      "symbol": "SAUCE",
      "icon": "/images/tokens/sauce.svg",
      "decimals": 6,
      "price": "36806544",
      "priceUsd": 0.01763457,
      "dueDiligenceComplete": true,
      "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"
    },
    "fee": 3000,
    "tickUpper": -1620,
    "tickLower": -2820,
    "liquidity": "3249809842",
    "feeGrowthInside0LastX128": "2546890053379859378523505791149585",
    "feeGrowthInside1LastX128": "1232345435623984092384092380932840",
    "tokensOwed0": "10",
    "tokensOwed1": "20"
  }
]