# 사용자 포지션

### 개요(Overview)

유동성을 제공한 후, Saros DLMM REST API를 통해 자신의 포지션을 조회할 수 있습니다. 두 가지 엔드포인트가 제공됩니다:

1. 빈 단위 포지션(Bin-Level Positions): 각 포지션의 빈(Bin)별 세부 정보를 조회
2. 풀 단위 포지션(Pool-Level Positions): 풀(Pool)별 집계된 요약 정보 조회

### 사용자 포지션 조회(Fetching User Positions)

유동성을 추가한 후, Liquidity Book API를 사용하여 자신의 포지션을 가져올 수 있습니다. 사용 가능한 엔드포인트는 다음과 같습니다.

#### 1. 빈 단위 포지션 조회(Fetch Bin-Level Positions)

이 엔드포인트는 사용자의 포지션에서 각 빈(Bin)에 대한 상세 정보를 반환합니다:

```
// Fetch bin-level positions
const fetchBinPositions = async (userId: string, pairId?: string) => {
  const params = new URLSearchParams({
    user_id: userId,
    page_num: "1",
    page_size: "100",
  });

  if (pairId) {
    params.append("pair_id", pairId);
  }

  const response = await fetch(`/api/bin-position?${params.toString()}`);
  if (!response.ok) {
    throw new Error("Failed to fetch bin positions");
  }

  return await response.json();
};

// Example usage
const binPositions = await fetchBinPositions(wallet.publicKey.toString());
console.log("Bin positions:", binPositions);

```

응답에는 사용자의 포지션에 포함된 각 빈(Bin)에 대한 상세 정보가 포함됩니다. 여기에는 다음이 포함됩니다:

* 빈 ID(Bin ID)
* 각 빈에 포함된 토큰 수량(Token amounts in each bin)
* 유동성 지분(Liquidity shares)
* 가격 정보(Price information)

### 2. 풀 단위 포지션 조회 (Fetch Pool-Level Positions)

이 엔드포인트는 사용자의 포지션을 풀 단위로 집계하여, 각 풀에서 보유한 전체 유동성에 대한 요약을 제공합니다.

```
// Fetch pool-level positions
const fetchPoolPositions = async (userId: string, pairId?: string) => {
  const params = new URLSearchParams({
    user_id: userId,
    page_num: "1",
    page_size: "100",
  });

  if (pairId) {
    params.append("pair_id", pairId);
  }

  const response = await fetch(`/api/pool-position?${params.toString()}`);
  if (!response.ok) {
    throw new Error("Failed to fetch pool positions");
  }

  return await response.json();
};

// Example usage
const poolPositions = await fetchPoolPositions(wallet.publicKey.toString());
console.log("Pool positions:", poolPositions);

```

각 풀에서 사용자의 포지션에 관한 응답(Response)에 포함되는 정보:

* 총 유동성 (Total liquidity)
* 총 토큰 수량 (Total token amounts)
* 풀 정보 (Pool information) – 수수료, 토큰 세부사항 등
* 가격 정보 (Price information)