PRprivy-io
Wallet Actions

Sell tMMF shares

Changed on

Sends fund shares from the registered wallet to the fund provider and tracks delivery of withdraw_asset as a wallet action. The wallet owner or signers authorize the request.

post/v1/wallets/{wallet_id}/earn/tmmf/withdraw

Request

  • Base URL
    https://api.privy.io
  • Auth
    HTTP basic

Path parameters

wallet_idstring required

ID of the wallet.

Headers

privy-app-idstring required

ID of your Privy app.

privy-authorization-signaturestring

Request authorization signature. If multiple signatures are required, they should be comma separated.

privy-request-expirystring

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

privy-idempotency-keystring

Idempotency keys ensure API requests are executed only once within a 24-hour window.

Request body

noncestring

Unique caller-generated nonce used to prevent replaying a signed wallet action request. Must be at least 24 characters (e.g. a cuid2 or UUID).

sharesstring required

Number of fund shares to redeem, e.g. "1000.000000".

withdraw_assetstring required

Currency of the proceeds, e.g. "USDC".

chainstring required

Chain the fund is held on, e.g. "ethereum_sepolia".

fundstring required

Fund ticker, e.g. "WTGXX". Case-insensitive.

order_type'primary' | 'secondary' required

How a tMMF order fills: secondary from the provider pool in minutes, or primary at the next NAV strike.

reference_idstring

Developer-provided identifier for this request. Must be unique per app.

Example request

{
  "shares": "1000.00",
  "withdraw_asset": "USDC",
  "chain": "ethereum_sepolia",
  "fund": "WTGXX"
}

Response

Redemption accepted: the pending wallet action.

idstring required

The ID of the wallet action.

status'pending' | 'succeeded' | 'rejected' | 'failed' required

The current status of the wallet action.

wallet_idstring required

The ID of the wallet involved in the action.

created_atstring date-time required

ISO 8601 timestamp of when the wallet action was created.

reference_idstring nullable

Developer-provided reference ID, if one was included in the request.

type'tmmf_withdraw' required

Example response

{
  "steps": [
    {
      "gas_credits_charged": {
        "value": "100.00",
        "currency": "usd"
      }
    }
  ]
}

Changes

  • 34a17702d072Revision changes
    • info

      removed subschema #2 from the /// response property allOf list for the response status

    • info

      removed subschema #2 from the /// response property allOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

  • 92cd740c9dc9Revision changes
    • info

      endpoint added