> ## Documentation Index
> Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Discover gVault yield sources

> Use the gVault catalogue to select a vault, network, asset, and contract interface.

Call the gVault-specific catalogue before configuring either a direct
integration or a fee wrapper. Every row returned by this endpoint is a gVault.

## List the catalogue

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://sandbox.groundtech.co/v2/gvaults/yield-sources \
  -H "Authorization: Bearer $GROUND_API_KEY"
```

The response is an unpaginated integration manifest.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": [
    {
      "id": "ground-ustb-vault",
      "name": "Ground USTB gVault",
      "chain": "ethereum_sepolia",
      "contractAddress": "0x5a68cfE0DCCcfA4991e5a92d2c382b15B41C4119",
      "asset": {
        "symbol": "USDC",
        "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "decimals": 6
      },
      "interface": "ground_ustb_v1"
    }
  ]
}
```

## Persist the integration fields

Store these values per environment:

| Field             | Use                                                  |
| ----------------- | ---------------------------------------------------- |
| `id`              | `gVaultId` in access and fee-wrapper API calls       |
| `chain`           | Network selection and transaction validation         |
| `contractAddress` | Direct onchain contract address                      |
| `interface`       | Contract-interface and operation-flow selection      |
| `asset`           | Deposit-token symbol, contract address, and decimals |

Always verify `asset()` onchain against the manifest before requesting an
ERC-20 approval.

## Select by capability

Use the `interface` field to choose the ABI described in
[gVault contract interfaces](/docs/gvaults/contract-interfaces). An
USTB-style source can expose synchronous deposits and withdrawals plus queued
redemptions. A Centrifuge-style source exposes request/claim lifecycles and may
require the configured Ground router for deposits.

Never copy IDs or addresses between sandbox and production. Fetch and validate
the catalogue after changing API base URL or chain configuration.

See the complete schema in
[List gVault yield sources](/api-reference/list-gvault-yield-sources).