---
title: "List tMMF positions"
method: GET
path: "/v1/wallets/{wallet_id}/earn/tmmf/positions"
tags: ["Wallet Actions"]
---

# List tMMF positions

`GET /v1/wallets/{wallet_id}/earn/tmmf/positions`

## Request

- Base URL: `https://api.privy.io`
- URL: `https://api.privy.io/v1/wallets/{wallet_id}/earn/tmmf/positions`
- Auth: HTTP basic

Returns a page of the wallet's tMMF positions for all providers: shares, their USD value at the latest NAV, pending dividends, and pending orders.

## Path parameters

- `wallet_id` string, required: ID of the wallet.

## Query parameters

- `cursor` string: Cursor returned by the previous page.
- `limit` integer
- `provider` union: The fund provider.
  - 'wisdomtree'
  - string
- `fund` string: Fund ticker, e.g. "WTGXX". Case-insensitive.
- `chain` string: Chain the fund is held on, e.g. "ethereum_sepolia".

## Headers

- `privy-app-id` string, required: ID of your Privy app.

## Response `200`

A page of tMMF positions.

- TmmfPositionResponse: A page of a wallet's tMMF positions for all providers: one per fund and chain the wallet is registered for.
  - `wallet_id` string, required: ID of the Privy wallet holding the positions.
  - `positions` TmmfPosition[], required: A page of the wallet's positions, one per registered fund and chain.
    - `provider` union, required: The fund provider.
      - 'wisdomtree'
      - string
    - `fund` string, required: Fund ticker, e.g. "WTGXX". Case-insensitive.
    - `chain` string, required: Chain the fund shares are held on, e.g. "base".
    - `shares` string, required: Fund shares held on-chain by the wallet.
    - `share_value_usd` string, nullable, required: `shares` valued at `nav_usd`, or null when the provider call fails.
    - `nav_usd` string, nullable, required: Latest published NAV per share in USD, or null when the provider call fails.
    - `nav_date` string, nullable, required: Publication date of the NAV, e.g. "2026-09-25", or null without one or when the provider call fails.
    - `pending_dividends_usd` string, nullable, required: Accrued, undistributed income in USD that is not yet spendable, or null when the provider call fails.
    - `pending_since` string, nullable, required: Start date of the open accrual period, e.g. "2026-09-01", or null without one or when the provider call fails.
    - `total_position_value_usd` string, nullable, required: Estimated share value plus available pending dividends, excluding settlement currency and in-transit assets; null without NAV.
    - `pending_orders` TmmfOrderActionResponse[], required: Wallet actions for purchases and redemptions that are still pending.
      - union: A tMMF purchase or redemption wallet action, discriminated on type.
        - object: A tokenized money market fund (tMMF) deposit.
          - `id` string, required: The ID of the wallet action.
          - `status` 'pending' | 'succeeded' | 'rejected' | 'failed', required: The current status of the wallet action.
          - `wallet_id` string, required: The ID of the wallet involved in the action.
          - `created_at` string, date-time, required: ISO 8601 timestamp of when the wallet action was created.
          - `reference_id` string, nullable: Developer-provided reference ID, if one was included in the request.
          - `failure_reason` object: Top-level failure context for the wallet action. Present on rejected or failed actions when available.
            - `message` string, required: Human-readable failure message.
            - `details` unknown
          - `steps` WalletActionStep[]: The steps of the wallet action. Only returned if `?include=steps` is provided.
            - union: A step within a wallet action, representing a single onchain action.
              - …
          - `type` 'tmmf_deposit', required
        - object: A tokenized money market fund (tMMF) withdrawal.
          - `id` string, required: The ID of the wallet action.
          - `status` 'pending' | 'succeeded' | 'rejected' | 'failed', required: The current status of the wallet action.
          - `wallet_id` string, required: The ID of the wallet involved in the action.
          - `created_at` string, date-time, required: ISO 8601 timestamp of when the wallet action was created.
          - `reference_id` string, nullable: Developer-provided reference ID, if one was included in the request.
          - `failure_reason` object: Top-level failure context for the wallet action. Present on rejected or failed actions when available.
            - `message` string, required: Human-readable failure message.
            - `details` unknown
          - `steps` WalletActionStep[]: The steps of the wallet action. Only returned if `?include=steps` is provided.
            - union: A step within a wallet action, representing a single onchain action.
              - …
          - `type` 'tmmf_withdraw', required
  - `next_cursor` string, nullable, required: Cursor of the next page of positions, or null on the last page.

## Changes

- **2026-11-06** `34a17702d072`: 8 info
  - removed `#/components/schemas/WisdomTreeSettlementReceivedAmount, subschema #2` from the `positions/items/pending_orders/items/oneOf[subschema #1: TmmfDepositActionResponse]/steps/items/oneOf[subschema #8: WisdomTreeSettlementWalletActionStep]/received` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/WisdomTreeSettlementReceivedAmount, subschema #2` from the `positions/items/pending_orders/items/oneOf[subschema #2: TmmfWithdrawActionResponse]/steps/items/oneOf[subschema #8: WisdomTreeSettlementWalletActionStep]/received` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/WisdomTreeSettlementRequestedAmount, subschema #2` from the `positions/items/pending_orders/items/oneOf[subschema #1: TmmfDepositActionResponse]/steps/items/oneOf[subschema #8: WisdomTreeSettlementWalletActionStep]/requested` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/WisdomTreeSettlementRequestedAmount, subschema #2` from the `positions/items/pending_orders/items/oneOf[subschema #2: TmmfWithdrawActionResponse]/steps/items/oneOf[subschema #8: WisdomTreeSettlementWalletActionStep]/requested` response property `allOf` list for the response status `200`
  - …4 more
- **2026-11-04** `92cd740c9dc9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/wallets/:wallet_id/earn/tmmf/positions/get.md)

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) - [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privy-io/apis/privy-api/revisions/393bfc513654?raw)