---
title: "Get User Liquidity"
method: GET
path: "/defi/v1/dex/getuserliquidity"
tags: ["dex"]
---

# Get User Liquidity

`GET /defi/v1/dex/getuserliquidity`

## Request

- Base URL: `https://svc.blockdaemon.com`
- URL: `https://svc.blockdaemon.com/defi/v1/dex/getuserliquidity`
- Auth: API key in header `X-API-Key`

Retrieves detailed liquidity information for a specific token pair held by an account. It returns the pair’s unique address along with the total liquidity and the individual balances for each token in the pair. This data is essential for users monitoring their decentralized liquidity positions and managing their exposure across various protocols.

> 💡 
**Compute Unit Value:** `60` (Fixed)

## Query parameters

- `tokenA` string, required: Address of the first token.
- `address` string, required: Public address of liquidity provider.
- `dexId` '1000' | '1001' | '1300' | '1301' | '1305' | '1306' | '1307' | '1308' | '1309' | '1310' | '1100' | '1101' | '1200' | '1201' | '2900' | '2901' | '2800' | '2808' | '2809' | '1500' | '1400' | '1402' | '2300' | '2100' | '2101' | '2500' | '2501' | '2700' | '2400' | '2401' | '3000' | '3001' | '3100' | '3500' | '3501' | '3400' | '3401' | '3600': The unique ID to specify the decentralized exchange (DEX) within a particular blockchain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-dexs-protocols).
- `tokenB` string, required: Address of the second token.
- `vsCurrencies` string: A comma-separated list of currency symbols to convert the amount into, such as 'USD,EUR'. This parameter is optional and allows retrieving values in multiple fiat currencies.
- `tokenId` string, required: The token ID for PancakeSwap V3 liquidity position.
- `poolAddress` string, required: Pool address whose liquidity is to be fetched.
- `tokenC` string: Address of the third token.
- `tokenD` string: Address of the forth token.
- `id` string, required: Bin ID whose liquidity is to be fetched.
- `positionNFT` string, required: LP token that represents a position in a pool.
- `path` string, required: Comma-separated values of token addresses whose price is to be fetched. Note: 1) Assets should be in lexicographic order. 2) For assets other than XLM (Native token), the token issuer is required.
- `poolId` string, required: Pool ID of the token pair.

## Response `200`

Successful response

- object
  - `status` integer
  - `msg` string
  - `data` object

---

[API](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api.md) - [All operations](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/revisions/ec053b7c8041?raw)