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

# List positions

> List a wallet's tokenized money market fund positions, their value, and pending orders.

Use the positions endpoint to show what a wallet holds in each fund. The response has one position for each fund and chain the wallet can trade on.

Each position shows:

* The shares the wallet holds onchain.
* Their value in USD at the latest NAV.
* The dividends that the fund has not paid out yet.
* The orders that are still in flight.

## Usage

To list a wallet's positions, send a `GET` request to:

```bash theme={"system"}
https://api.privy.io/v1/wallets/{wallet_id}/earn/tmmf/positions
```

### Parameters

All query parameters are optional. Use them to pick the environment, filter the list, or page through it.

**environment** `'sandbox' | 'production'`

The WisdomTree environment to read. Defaults to `production`.

**provider** `'wisdomtree'`

Only return positions with this provider.

**fund** `string`

Only return positions in this fund, e.g. `"WTGXX"`.

**chain** `string`

Only return positions on this chain, e.g. `"ethereum_sepolia"`.

**limit** `number`

The maximum number of positions to return.

**cursor** `string`

The cursor of the page of positions to return, from `next_cursor`.

### Returns

The response lists the positions and a cursor for the next page.

**wallet\_id** `string`

The ID of the wallet holding the positions.

**positions** `object[]`

A page of the wallet's positions, one per registered fund and chain.

**child attributes**

**provider** `'wisdomtree'`

The fund provider.

**fund** `string`

The fund ticker, e.g. `"WTGXX"`.

**chain** `string`

The chain the shares are held on.

**shares** `string`

The fund shares the wallet holds onchain.

**share\_value\_usd** `string | null`

`shares` valued at `nav_usd`.

**nav\_usd** `string | null`

The latest published NAV per share in USD.

**nav\_date** `string | null`

The publication date of the NAV, e.g. `"2026-11-01"`.

**pending\_dividends\_usd** `string | null`

Accrued dividends in USD that are not yet paid out.

**pending\_since** `string | null`

The start date of the open accrual period, e.g. `"2026-11-01"`.

**total\_position\_value\_usd** `string | null`

The estimated share value plus pending dividends. It excludes stablecoins the wallet holds and
assets in transit. `null` without a NAV.

**pending\_orders** `object[]`

The wallet's [purchases](https://docs.privy.io/wallets/actions/earn/tokenized-money-market-funds/buy.md#returns) and
[sales](https://docs.privy.io/wallets/actions/earn/tokenized-money-market-funds/sell.md#returns) in this fund that are
still `pending`.

**next\_cursor** `string | null`

The cursor of the next page of positions, or `null` on the last page.

> [!NOTE]
>
> Privy reads the NAV and the dividends from WisdomTree. If WisdomTree does not answer, these fields
> are `null`. The response still includes `shares` and `pending_orders`.

### Example

This request lists the wallet's WTGXX positions.

```bash theme={"system"}
curl "https://api.privy.io/v1/wallets/{wallet_id}/earn/tmmf/positions?fund=WTGXX&environment=sandbox" \
  -H "privy-app-id: <your-app-id>" \
  -H "Authorization: Basic <credentials>"
```

```json Example response theme={"system"}
{
  "wallet_id": "<your-wallet-id>",
  "positions": [
    {
      "provider": "wisdomtree",
      "fund": "WTGXX",
      "chain": "ethereum_sepolia",
      "shares": "9.990000",
      "share_value_usd": "9.99",
      "nav_usd": "1.00",
      "nav_date": "2026-11-01",
      "pending_dividends_usd": "0.02",
      "pending_since": "2026-11-01",
      "total_position_value_usd": "10.01",
      "pending_orders": []
    }
  ],
  "next_cursor": null
}
```

## Next steps

Use webhooks to know when an order completes. Then list the positions again.

> [card] [Webhooks](https://docs.privy.io/wallets/actions/earn/tokenized-money-market-funds/webhooks.md)
>
> Refresh positions when orders complete.