---
title: "Get all liquidity positions by account id"
method: GET
path: "/v2/nfts/{accountId}/positions"
tags: ["SaucerSwap V2"]
---

# Get all liquidity positions by account id

`GET /v2/nfts/{accountId}/positions`

## Request

- Base URL: `https://api.saucerswap.finance`
- URL: `https://api.saucerswap.finance/v2/nfts/{accountId}/positions`
- Auth: none required
- TypeScript: <https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/docs/v2/nfts/:accountId/positions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `accountId` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Successful response

- PositionV2[]
  - `tokenSN` integer, required: NFT serial number representing user's position
  - `accountId` string, required: Hedera account id (shard.realm.num)
  - `deleted` boolean, required: True if this position was deleted otherwise false
  - `createdAt` string, required: Unix timestamp when this position was created
  - `updatedAt` string, required: Unix timestamp when this position was updated
  - `token0` Token, required
    - `id` string, required: Token id (shard.realm.num)
    - `name` string, required: Token name
    - `symbol` string, required: Token symbol
    - `icon` string, required: Relative path to the token icon
    - `decimals` integer, required: Token decimal places
    - `price` string, required: Token price in tinybar
    - `priceUsd` number, required: Token price in terms of USD
    - `dueDiligenceComplete` boolean, required: Token due diligence completed?
    - `isFeeOnTransferToken` boolean, required: Token has fees on transfer?
    - `description` string, required: Token description
    - `website` string, required: Token website link
    - `sentinelReport` string, required: Token sentinel report link
    - `twitterHandle` string, required: Token sentinel report link
  - `token1` Token, required
    - `id` string, required: Token id (shard.realm.num)
    - `name` string, required: Token name
    - `symbol` string, required: Token symbol
    - `icon` string, required: Relative path to the token icon
    - `decimals` integer, required: Token decimal places
    - `price` string, required: Token price in tinybar
    - `priceUsd` number, required: Token price in terms of USD
    - `dueDiligenceComplete` boolean, required: Token due diligence completed?
    - `isFeeOnTransferToken` boolean, required: Token has fees on transfer?
    - `description` string, required: Token description
    - `website` string, required: Token website link
    - `sentinelReport` string, required: Token sentinel report link
    - `twitterHandle` string, required: Token sentinel report link
  - `fee` integer, required: Swap fee tier denoted in basis points
  - `tickUpper` integer, required: Upper end of the position's price range
  - `tickLower` integer, required: Lower end of the position's price range
  - `liquidity` string, required: The amount of liquidity provided by the position
  - `feeGrowthInside0LastX128` string, required: Accumulated fee growth for token0 inside the tick range since the last time liquidity was added or removed
  - `feeGrowthInside1LastX128` string, required: Accumulated fee growth for token1 inside the tick range since the last time liquidity was added or removed
  - `tokensOwed0` string, required: Total amount of token0 owed to the position due to fees generated from swaps within the position's price range
  - `tokensOwed1` string, required: Total amount of token1 owed to the position due to fees generated from swaps within the position's price range

---

[API](https://skmtc.dev/saucerswap/apis/saucerswap-rest-api.md) - [All operations](https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/saucerswap/apis/saucerswap-rest-api/revisions/6c4d55a0e793?raw)
