List positions

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:

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.

'sandbox' | 'production'

The WisdomTree environment to read. Defaults to production.

'wisdomtree'

Only return positions with this provider.

string

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

string

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

number

The maximum number of positions to return.

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.

string

The ID of the wallet holding the positions.

object[]

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

Show child attributes

'wisdomtree'

The fund provider.

string

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

string

The chain the shares are held on.

string

The fund shares the wallet holds onchain.

shares valued at nav_usd.

string | null

The latest published NAV per share in USD.

string | null

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

string | null

Accrued dividends in USD that are not yet paid out.

string | null

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

string | null

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

object[]

The wallet’s purchases and sales in this fund that are still pending.

string | null

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

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.

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>"

Example response

{
  "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.

Webhooks

Refresh positions when orders complete.

Earn

Tokenized money market funds

DeFi vaults

Usage

Parameters

Returns

Example

Next steps

Webhooks

​Usage

​Parameters

​Returns

​Example

​Next steps

Webhooks

Usage

Parameters

Returns

Example

Next steps