Purchase flow
- Privy creates the order as a wallet action with status
pending, and sends the wallet’s stablecoins to WisdomTree. - WisdomTree fills the order. A
secondaryorder fills from the fund’s onchain pool. Aprimaryorder fills at the daily NAV strike. - The status moves to
succeededonce the shares reach the wallet.
Usage
To buy fund shares, send aPOST request to:
Parameters
The body describes the order.The amount of
deposit_asset to invest, as a decimal string in the asset’s standard unit, e.g.
"1000.00".The WisdomTree environment the order trades in. Defaults to
production. Use sandbox to test.
See how the sandbox
works.How the order fills:
secondary from the fund’s onchain pool, which is faster, or primary
directly with the fund at the daily NAV strike.Wallets with
owner_id present must provide an authorization
signature as a request header.Returns
The endpoint returns the order as a wallet action.The wallet action ID of the order. Use this to poll status with get wallet action.
Example
This request buys 10 USDC of WTGXX from the fund’s pool.Example response
Idempotency on errors: This endpoint returns
pending immediately. Replaying the same key
returns the cached response. On a synchronous 5xx, Privy deletes the record so the same key
retries fresh. Action outcomes (rejected, failed, succeeded) arrive via
webhooks and polling. Policy violations
always allow fresh retries.Statuses and failures
An order has one of four statuses. Every status butpending is final.
Common errors
The endpoint returns an error, and creates no order, when it cannot place the order.Next steps
Once the order succeeds, show the new position. Or sell shares back for stablecoins.List positions
Show the wallet’s shares, their value, and pending orders.
Sell fund shares
Sell fund shares for stablecoins.

