Skip to main content
GET
/
v2
/
nfts
/
{accountId}
/
positions
Get all liquidity positions by account id
curl --request GET \
  --url https://api.saucerswap.finance/v2/nfts/{accountId}/positions \
  --header 'x-api-key: <x-api-key>'
[
  {
    "tokenSN": 160,
    "accountId": "0.0.12345",
    "deleted": false,
    "createdAt": "1697779560.762467685",
    "updatedAt": "1698287867.747005303",
    "token0": {
      "decimals": 8,
      "icon": "/images/tokens/hbar.png",
      "id": "0.0.59042",
      "name": "WHBAR [new]",
      "price": "100000000",
      "priceUsd": 0.0598982,
      "symbol": "HBAR",
      "dueDiligenceComplete": true,
      "isFeeOnTransferToken": false,
      "description": "Hedera is a public, open source, proof-of-stake network, with native cryptocurrency HBAR...",
      "website": "https://hedera.com/",
      "twitterHandle": "hedera"
    },
    "token1": {
      "decimals": 6,
      "icon": "/images/tokens/sauce.png",
      "id": "0.0.61266",
      "name": "SAUCE",
      "price": "24609831",
      "priceUsd": 0.0147408436767304,
      "symbol": "SAUCE",
      "dueDiligenceComplete": true,
      "isFeeOnTransferToken": false,
      "description": "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera...",
      "website": "https://www.saucerswap.finance/",
      "twitterHandle": "SaucerSwapLabs"
    },
    "fee": 3000,
    "tickUpper": -1620,
    "tickLower": -2820,
    "liquidity": "3249809842",
    "feeGrowthInside0LastX128": "2546890053379859378523505791149585",
    "feeGrowthInside1LastX128": "1232345435623984092384092380932840",
    "tokensOwed0": "10",
    "tokensOwed1": "20"
  }
]
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

​
accountId
string
required

Hedera account id (shard.realm.num)

Example:

"0.0.12345"

Response

200 - application/json

Successful response

​
tokenSN
integer
required

NFT serial number representing user's position

Example:

160

​
accountId
string
required

Hedera account id (shard.realm.num)

Example:

"0.0.12345"

​
deleted
boolean
required

True if this position was deleted otherwise false

Example:

false

​
createdAt
string
required

Unix timestamp when this position was created

Example:

"1697779560.762467685"

​
updatedAt
string
required

Unix timestamp when this position was updated

Example:

"1698287867.747005303"

​
token0
object
required
Example:
{
  "decimals": 8,
  "icon": "/images/tokens/hbar.png",
  "id": "0.0.59042",
  "name": "WHBAR [new]",
  "price": "100000000",
  "priceUsd": 0.0598982,
  "symbol": "HBAR",
  "dueDiligenceComplete": true,
  "isFeeOnTransferToken": false,
  "description": "Hedera is a public, open source, proof-of-stake network, with native cryptocurrency HBAR...",
  "website": "https://hedera.com/",
  "twitterHandle": "hedera"
}
​
token1
object
required
Example:
{
  "decimals": 6,
  "icon": "/images/tokens/sauce.png",
  "id": "0.0.61266",
  "name": "SAUCE",
  "price": "24609831",
  "priceUsd": 0.0147408436767304,
  "symbol": "SAUCE",
  "dueDiligenceComplete": true,
  "isFeeOnTransferToken": false,
  "description": "SaucerSwap is an open source and non-custodial AMM protocol native to Hedera...",
  "website": "https://www.saucerswap.finance/",
  "twitterHandle": "SaucerSwapLabs"
}
​
fee
integer
required

Swap fee tier denoted in basis points

Example:

3000

​
tickUpper
integer
required

Upper end of the position's price range

Example:

-1620

​
tickLower
integer
required

Lower end of the position's price range

Example:

-2820

​
liquidity
string
required

The amount of liquidity provided by the position

Example:

"3249809842"

​
feeGrowthInside0LastX128
string
required

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

Example:

"2546890053379859378523505791149585"

​
feeGrowthInside1LastX128
string
required

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

Example:

"1232345435623984092384092380932840"

​
tokensOwed0
string
required

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

Example:

"10"

​
tokensOwed1
string
required

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

Example:

"20"