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.

User Positions

What does a wallet currently hold? Idle token balances plus DeFi positions, matching the Turtle app portfolio.

Wallet Activity

What has a wallet done? Deposit and withdrawal history for one or more addresses, across all distributors.

Distributor Activity

What flowed through my integration? Deposits attributed to your distributor.

Choosing the right endpoint

Question	Endpoint
What does this wallet hold right now (tokens + DeFi)?	Positions
What deposits and withdrawals has this wallet made?	Wallet Activity
Which deposits were attributed to my distributor?	Distributor Activity

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.