> For the complete documentation index, see [llms.txt](https://sodex.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sodex.com/documentation/for-developers/developers/wealth.md).

# Wealth

SoDEX Wealth lists two product lines on ValueChain. Discover them at runtime with the Wealth API and branch on `fundType`. Do not apply the vault request/claim flow to a SoDEX RWA token, or the reverse.

| `fundType`     | Product         | What to do                                                                                                     |
| -------------- | --------------- | -------------------------------------------------------------------------------------------------------------- |
| `escrow_vault` | Vault           | Asynchronous deposit and redemption against the fund's vault contracts.                                        |
| `clob`         | SoDEX RWA token | A CLOB-listed token (for example `vQQQ`, `vVOO`). Not a vault. Do not call `requestDeposit` / `requestRedeem`. |

Each fund has its own `fundId`, `fundStatus`, and (for vaults) underlying asset, minimums, contracts, and settlement timing.

A vault request does not mint shares or return assets in the same transaction. Track settlement and claim only when the result was not automatically delivered. The vault spends a **ValueChain** balance of the underlying asset. If that balance is still on an external network, move it with [Mirror Protocol](/documentation/for-developers/developers/mirror-protocol.md) first.

**Mainnet Wealth API:** `https://mainnet-gw.sodex.dev/api/v1/wealth`

## Start here

{% content-ref url="/pages/HsGuBebtzTDPQcpfRUyF" %}
[Quickstart](/documentation/for-developers/developers/wealth/quickstart.md)
{% endcontent-ref %}

{% content-ref url="/pages/1iM5s4DAQTw3afqqUnG3" %}
[Wealth Contracts](/documentation/for-developers/developers/wealth/contracts.md)
{% endcontent-ref %}

{% content-ref url="/pages/0JPfycqwKsnQ2suYPttG" %}
[Referrals](/documentation/for-developers/developers/wealth/referrals.md)
{% endcontent-ref %}

{% content-ref url="/pages/a1uIUuv4ujFrQ0lk4JjC" %}
[Vault Lifecycle](/documentation/for-developers/developers/wealth/vault-lifecycle.md)
{% endcontent-ref %}

Vault how-tos (direct or signed submit, settlement) are under [Vault Lifecycle](/documentation/for-developers/developers/wealth/vault-lifecycle.md).

## API Reference

{% content-ref url="/pages/aQ6Q5f14MXj2NyvjBB9V" %}
[Wealth API](/documentation/for-developers/api-reference/wealth-api.md)
{% endcontent-ref %}

## How it fits into SoDEX

A vault does not credit Spot or Perps. Vault shares are the fund's ERC-20 on ValueChain. Whether to claim is decided by User Fund History (`claimable`, `delayedPending`) and the on-chain request — not by assuming every request needs `claimDeposit` or `claimRedeem`.

A `clob` fund is a SoDEX RWA token that trades on SoDEX CLOB. Use [Trading](/documentation/for-developers/developers/trading.md) for that market; the vault pages on this hub do not apply.
