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

# Overview

> Choose the right endpoint for positions, wallet activity, or distributor activity.

Three endpoints answer three different questions about what is happening with funds. Pick by the question you are answering, not by the resource name.

<CardGroup cols={2}>
  <Card title="User Positions" icon="chart-pie" href="/sdk/portfolio/positions">
    What does a wallet currently hold, across every supported protocol? Live balances and net value.
  </Card>

  <Card title="Wallet Activity" icon="clock-rotate-left" href="/sdk/portfolio/activity">
    What has a wallet done? Deposit and withdrawal history for one or more addresses, across all distributors.
  </Card>

  <Card title="Distributor Activity" icon="chart-mixed" href="/sdk/earn-api/deposits">
    What flowed through my integration? Deposits attributed to your distributor.
  </Card>
</CardGroup>

## Choosing the right endpoint

| Question                                            | Endpoint                                       |
| --------------------------------------------------- | ---------------------------------------------- |
| What does this wallet hold right now?               | [Positions](/sdk/portfolio/positions)          |
| What deposits and withdrawals has this wallet made? | [Wallet Activity](/sdk/portfolio/activity)     |
| Which deposits were attributed to my distributor?   | [Distributor Activity](/sdk/earn-api/deposits) |

The split that trips people up is Wallet Activity versus Distributor Activity. Wallet Activity is scoped by wallet address and spans every distributor; Distributor Activity is scoped by your distributor ID. Both return the same per-interaction shape. Use Wallet Activity for user-facing portfolio history, and Distributor Activity for attribution and volume reporting.
