> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pods.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Open Positions

> Learn how to retrieve and monitor current yield positions for a wallet address

In this section, we'll learn how to retrieve the current yield positions for an address.

<Info>
  **Prerequisites:**

  * [How to Check Protocol Info](/guides/yield/check-protocol-info)
  * [How to Deposit](/guides/yield/deposit)
</Info>

## Retrieve Current Positions

Use the following endpoint to retrieve all the current yield positions of an address:

```http theme={null}
GET /wallets/:wallet
```

**Required Parameters:**

| Parameter | Description    | Example                                      |
| --------- | -------------- | -------------------------------------------- |
| wallet    | Wallet address | `0x1234567890123456789012345678901234567890` |

**Example Request:**

```http theme={null}
GET /wallets/0x1234567890123456789012345678901234567890
```

## Response Format

The response returns an array of yield positions with spot performance data and the full strategy object for each.

**Example Response:**

```json theme={null}
{
  "positions": [
    {
      "spotPosition": {
        "currentPosition": {
          "value": "10048700",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "profit": {
          "value": "48700",
          "decimals": 6,
          "humanized": "0.0487",
          "symbol": "USDC"
        },
        "cumulativeProfit": {
          "value": "48700",
          "decimals": 6,
          "humanized": "0.0487",
          "symbol": "USDC"
        },
        "principal": {
          "value": "10000000",
          "decimals": 6,
          "humanized": "10.00",
          "symbol": "USDC"
        },
        "underlyingBalanceUSD": 10.05,
        "apy": 0.0417,
        "grossAPY": 0.0417,
        "netAPY": 0.0396,
        "avgApy": 0.0412,
        "inceptionApy": 0.0385
      },
      "strategy": {
        "id": "Aave-USDC-polygon",
        "protocol": "Aave",
        "assetName": "USDC",
        "network": "polygon",
        "networkId": "137",
        "asset": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
        "assetDecimals": 6,
        "apy": 0.0417,
        "paused": false,
        "fee": "0",
        "availableActions": ["lend", "withdraw"]
      }
    }
  ],
  "summary": {
    "totalUnderlyingBalanceUSD": 10.05
  }
}
```

## Understanding the Response

<AccordionGroup>
  <Accordion title="spotPosition.currentPosition" icon="scale-balanced">
    Raw balance as a BigInt string in the token's smallest unit (e.g. `"10000000"` = 10 USDC)
  </Accordion>

  <Accordion title="spotPosition.underlyingBalanceUSD" icon="dollar-sign">
    USD value of the position
  </Accordion>

  <Accordion title="spotPosition.profit" icon="chart-line">
    Current gain or loss of the position relative to the cost basis still invested, taking into account adjustments such as partial withdrawals. This reflects the true economic result of the open position — what the client has effectively earned on the capital that remains deployed.
  </Accordion>

  <Accordion title="spotPosition.cumulativeProfit" icon="sigma">
    A simpler accumulated view of the overall result: the current position value minus the total net amount moved by the client (deposits minus withdrawals). This does not adjust for the changing cost basis and gives a straightforward picture of how much value has been generated since inception.
  </Accordion>

  <Accordion title="spotPosition.apy / grossAPY / netAPY / avgApy / inceptionApy" icon="percent">
    * `apy`: Current APY as a decimal (e.g. `0.0417` = 4.17%)
    * `grossAPY`: APY before performance fees are deducted (decimal). May be `null` when not applicable.
    * `netAPY`: APY after performance fees are deducted (decimal). May be `null` when not applicable.
    * `avgApy`: Time-weighted average APY since inception
    * `inceptionApy`: APY since the strategy launched
  </Accordion>

  <Accordion title="spotPosition.requestedToLend / requestedToWithdraw" icon="clock">
    For strategies with queued (request-based) investment flows, these arrays contain pending amounts not yet settled on-chain:

    * `requestedToLend`: Array of amounts pending deposit (e.g. a `request-lend` action that is PENDING)
    * `requestedToWithdraw`: Array of amounts pending withdrawal (e.g. a `request-withdraw` action that is PENDING)

    Each entry has the same shape as `currentPosition` (`value`, `decimals`, `humanized`, `symbol`). These fields are only present on strategies that support the `request-lend` / `request-withdraw` action flow.
  </Accordion>

  <Accordion title="strategy" icon="landmark">
    Full strategy object (same shape as `GET /strategies/:id`) including protocol, network, asset details, and fee
  </Accordion>

  <Accordion title="summary.totalUnderlyingBalanceUSD" icon="wallet">
    Total portfolio value in USD across all positions
  </Accordion>
</AccordionGroup>

## UI Integration Example

<img src="https://mintcdn.com/pods-322144f0/PSxNnLu18cQmp9yS/images/yield-positions-example.png?fit=max&auto=format&n=PSxNnLu18cQmp9yS&q=85&s=6df7ac0aa0eaea16cbf78cd55284743d" alt="Active yield positions in UI" width="273" height="563" data-path="images/yield-positions-example.png" />

*Example UI showing active yield positions*

## Next Steps

<CardGroup cols={2}>
  <Card title="Withdraw" icon="arrow-down-right" href="/guides/yield/withdraw">
    Learn how to withdraw from a position
  </Card>

  <Card title="New Deposit" icon="arrow-up-right-dots" href="/guides/yield/deposit">
    Open a new yield position
  </Card>
</CardGroup>