Discover gtoken yield sources

Call the gtoken catalogue before configuring either a direct integration or a fee wrapper. Each row identifies a gtoken yield source and the backing vault contract used to obtain and redeem its tokens.

List the catalogue

curl https://sandbox.groundtech.co/v2/gvaults/yield-sources \
  -H "Authorization: Bearer $GROUND_API_KEY"

The response is an unpaginated integration manifest.

{
  "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 select the ABI for the returned contract. The gtoken contracts page links to the verified deployed contracts, where Etherscan exposes the current ABI and read methods. 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 gtoken yield sources.

Getting Started

Integration Guides

Operations

Resources

Discover gtoken yield sources

List the catalogue

Persist the integration fields

Select by capability

​List the catalogue

​Persist the integration fields

​Select by capability

List the catalogue

Persist the integration fields

Select by capability