Quickstart
Discover a Wealth fund at runtime, then follow the path for its fundType. Do not send a vault request to a SoDEX RWA token.
Mainnet base URL: https://mainnet-gw.sodex.dev/api/v1/wealth
There is no Testnet Wealth API. Contract addresses for vaults are on Wealth Contracts.
1. List funds
curl -sS 'https://mainnet-gw.sodex.dev/api/v1/wealth/asset/list' \
-H 'Accept: application/json'Select a fund by its case-sensitive fundId. Branch on fundType before loading contracts or sending a transaction.
fundType
Product
Next step
clob
SoDEX RWA token
Stop here. Trade on CLOB with Trading. Do not call asset/info expecting vault contracts, and do not call requestDeposit / requestRedeem.
nav and aum are vault valuation fields. They can be empty on a clob fund.
2. Vault configuration
This step applies only to escrow_vault. Replace CXMT with the selected fundId.
curl -sS 'https://mainnet-gw.sodex.dev/api/v1/wealth/asset/info?fundId=CXMT' \
-H 'Accept: application/json'Use data.contracts and data.chainConfig at runtime. Do not hardcode a per-fund address from an example. An empty data object means this fundId has no vault configuration — do not infer a vault.
Check fundStatus and chainConfig.paused. A vault deposit spends the underlying asset on ValueChain. If that balance is still on an external network, move it with Mirror Protocol first. The wallet needs SOSO for gas.
3. Choose the vault operation
Encode the referral value first (Referrals), including bytes32(0) when none applies. Then follow Vault Lifecycle:
Enter a vault that is accepting deposits
Approve the underlying asset and submit requestDeposit. This is not an instant mint.
Exit a vault that is accepting redemptions
Submit requestRedeem for vault shares you already hold. Wait for settlement.
Direct and signed submission and claims are how-tos under Vault Lifecycle. A CLOB fill for a SoDEX RWA token is not a vault request.
4. Confirm the result
A successful submission is not arrival.
For a vault, save the request transaction hash and query User Fund History. Amounts and prices are decimal strings; do not parse them as floating-point JSON numbers.
Match the saved hash and operation kind. Empty entries or processing do not confirm credit. Claim only when history and the on-chain request say the result was not automatically delivered. Then check the vault share or underlying balance.
For a SoDEX RWA token, confirm the Spot position. Do not use fund-details claim flags for that trade.
Last updated