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

# Funds

List visible funds and load one fund's contracts, chain parameters, and subscription terms.

`fundType` is `escrow_vault`, `clob`, or `bridged_vault`. `fundStatus` is `subscription` or `live`.

## List funds

`GET /funds`

```bash
curl "https://mainnet-gw.sodex.dev/api/v1/wealth/funds" \
  -H "Accept: application/json"
```

The response lists only listed funds. Unlisted funds are omitted. Each item includes the share token, key parameters, and whether the fund is in subscription or already live.

| Field        | Type             | Description                                                                                                          |
| ------------ | ---------------- | -------------------------------------------------------------------------------------------------------------------- |
| `fundId`     | string           | Case-sensitive identifier used by the other Wealth endpoints.                                                        |
| `name`       | string           | Display name.                                                                                                        |
| `fundType`   | string           | `escrow_vault`, `clob`, or `bridged_vault`.                                                                          |
| `iconUrl`    | string, optional | Icon URL.                                                                                                            |
| `tagline`    | string, optional | Short description.                                                                                                   |
| `fundStatus` | string           | `subscription` or `live`.                                                                                            |
| `nav`        | string, optional | Latest net asset value per share. Omitted for a `clob` fund, and for a `bridged_vault` until an external NAV exists. |
| `aum`        | string, optional | Assets under management. Omitted for `clob` and `bridged_vault`.                                                     |
| `asOf`       | string           | Snapshot time, RFC 3339 UTC.                                                                                         |
| `share`      | object           | Share token: `coin`, `address`, and `decimals`.                                                                      |
| `spot`       | object, optional | CLOB pair after it is synced: `symbol`, `symbolId`, `displayName`, and `quote` (`coin`, `decimals`).                 |

## Get fund information

`GET /funds/{fundId}`

```bash
curl "https://mainnet-gw.sodex.dev/api/v1/wealth/funds/CXMT" \
  -H "Accept: application/json"
```

| Name     | Location | Type   | Required | Description                     |
| -------- | -------- | ------ | -------- | ------------------------------- |
| `fundId` | path     | string | Yes      | Case-sensitive fund identifier. |

`data` includes every field from [List funds](#list-funds), plus the description, issuer, inception date, contract addresses, on-chain parameters, and subscription terms. A missing fund and an unlisted fund both come back as a not-found error in the standard envelope.

| Field           | Type             | Description                                                 |
| --------------- | ---------------- | ----------------------------------------------------------- |
| `description`   | string, optional | Fund description.                                           |
| `issuerName`    | string, optional | Issuer name.                                                |
| `inceptionDate` | string, optional | Inception date.                                             |
| `contracts`     | object           | Bound addresses. A role this fund does not have is omitted. |
| `chainConfig`   | object or `null` | On-chain parameter snapshot.                                |
| `subscription`  | object, optional | Present for an `escrow_vault` fund with a bound escrow.     |

`contracts` may include `vault`, `market`, `asset`, and `subscription`.

| `chainConfig` field | Type    | Description                             |
| ------------------- | ------- | --------------------------------------- |
| `assetDecimals`     | integer | Decimals of the underlying asset.       |
| `minDeposit`        | string  | Minimum deposit in raw asset units.     |
| `minRedeemShares`   | string  | Minimum redemption in raw share units.  |
| `mgmtFeeRate`       | string  | Management fee rate, raw 1e18 decimal.  |
| `perfFeeRate`       | string  | Performance fee rate, raw 1e18 decimal. |
| `exchangeRate`      | string  | Exchange rate, raw 1e18 decimal.        |
| `paused`            | boolean | Whether the vault is paused.            |
| `asOfBlock`         | integer | Block of this snapshot.                 |

| `subscription` field     | Type    | Description               |
| ------------------------ | ------- | ------------------------- |
| `subscribeDeadline`      | integer | Subscribe deadline.       |
| `unsubscribeDeadline`    | integer | Unsubscribe deadline.     |
| `totalSubscribed`        | string  | Total subscribed amount.  |
| `minimumSubscribeAmount` | string  | Minimum subscribe amount. |

Load these addresses at runtime, then call the methods in [Vault Contracts](/for-developers/api-reference/wealth-api/vault-contracts.md).

## Legacy asset list

`GET /asset/list`

Deprecated. New clients should use [List funds](#list-funds).

```bash
curl "https://mainnet-gw.sodex.dev/api/v1/wealth/asset/list" \
  -H "Accept: application/json"
```

The response is an array of public summaries.

| Field        | Type   | Description                                      |
| ------------ | ------ | ------------------------------------------------ |
| `fundId`     | string | Case-sensitive identifier.                       |
| `symbol`     | string | Short display symbol.                            |
| `name`       | string | Display name.                                    |
| `fundType`   | string | `escrow_vault`, `clob`, or `bridged_vault`.      |
| `fundStatus` | string | `subscription` or `live`.                        |
| `nav`        | string | Latest net asset value per share.                |
| `aum`        | string | Assets under management in the settlement asset. |
| `asOf`       | string | Snapshot time, RFC 3339 UTC.                     |

When the fund service cannot be reached, `error` is `internal server error: wealth fund service unavailable`.

## Legacy asset information

`GET /asset/info?fundId={fundId}`

Deprecated. New clients should use [Get fund information](#get-fund-information).

```bash
curl "https://mainnet-gw.sodex.dev/api/v1/wealth/asset/info?fundId=CXMT" \
  -H "Accept: application/json"
```

| Name     | Type   | Required | Description                                                            |
| -------- | ------ | -------- | ---------------------------------------------------------------------- |
| `fundId` | string | Yes      | Case-sensitive identifier. A missing `fundId` is an invalid parameter. |

`data` contains `baseInfo`, `marketInfo`, `fundInfo`, `contracts`, `chainConfig`, and `subscription`. A fund with no company record still returns the fund payload, with an empty `baseInfo`. `baseInfo` fields are omitted or `null` in that case.

| Section        | Description                                                                          |
| -------------- | ------------------------------------------------------------------------------------ |
| `baseInfo`     | Full name, introduction, and public links.                                           |
| `marketInfo`   | Market activity, valuation, and share statistics.                                    |
| `fundInfo`     | Identifier, symbol, type, status, NAV, AUM, issuer, inception date, and update time. |
| `contracts`    | `vault`, `market`, `asset`, and `subscription` addresses.                            |
| `chainConfig`  | Decimals, minimums, fee rates, exchange rate, `paused`, and `asOfBlock`.             |
| `subscription` | Deadlines, total subscribed, and minimum subscribe amount.                           |
