How the sandbox works
Each TMMF request names its WisdomTree environment in theenvironment field. A request without the field uses production.
- Sandbox: open to every app, for testing. Trades settle on Ethereum Sepolia.
- Production: for real trades. Only apps with production access can use it. Other apps get a
403error.
POST requests take environment in the body. GET requests take it as a query parameter.
Sandbox and production data are separate. Users onboard again in production.
The sandbox uses these settings:
The TMMF endpoints use your app’s credentials:
privy-app-id and Authorization: Basic <credentials> with your app secret. Purchases and redemptions also need an authorization
signature when the wallet has an owner.Integration flow
An integration follows these steps, in order.1
Create the user and their wallet
For a business, create an organization and an
organization wallet. For an individual, create a
user and a wallet the user owns. In the sandbox, the wallet must
be an Ethereum wallet.
2
3
Register the wallet
Register the wallet with
WisdomTree on
ethereum_sepolia. The wallet can trade once WisdomTree approves it.4
Fund the wallet
Send Sepolia USDC to the wallet, for example from the Circle
faucet. The wallet pays gas in Sepolia ETH unless your app has gas
sponsorship configured.
5
Buy fund shares
Buy WTGXX with USDC. Privy sends the
USDC to WisdomTree and tracks the order as a wallet action until the shares reach the wallet.
6
Track positions
List the wallet’s positions
to show shares, their USD value, pending dividends, and pending orders.
7
Sell fund shares
Sell WTGXX for USDC. Privy sends the
shares to WisdomTree and tracks the order until the proceeds reach the wallet.
Order types
Each order sets an order type. It decides how WisdomTree fills the order.
To test a full buy and sell quickly, use
secondary orders.
Next steps
Start by onboarding the user that will trade.Onboard businesses
Submit an organization’s KYB data to WisdomTree.
Onboard individuals
Submit an individual’s KYC data to WisdomTree.

