Available yield sources
Fetch the portfolio asset catalog before creating or updating a strategy. It lists the assets visible to your organization; production and sandbox can support different sources and chains. SetBASE_URL and API_TOKEN for your environment as described in
API conventions, then call:
data. Select entries with kind: "yield_source";
stock entries have kind: "stock". The response contains the full catalog, so
nextCursor is always null.
This illustrative response shows one yield source. If apyBps is null, display
the historical rate as unavailable, not zero.
Check purchase access
An asset can appear in the catalog before Ground enables purchases for your organization. In production, organizations with limited self-serve access cannot make new purchases of Superstate, Centrifuge, Etherfuse, or Ondo products. Figure products, including Tempo PRIME, remain available under the usual source mode and route requirements. Morpho, Aave, Maple, and Kamino remain available. Checker, Kii Global, PEXX, and organizations created through the Checker portal cannot make new Centrifuge purchases in production, even with full production access. Their other purchases remain subject to the usual product approvals. CheckpurchaseAvailability.enabled before offering a buy. If it is false, disable
purchases, display purchaseAvailability.reason, and contact Ground for access.
Ondo and Etherfuse also require their product access to be enabled. Check the
asset’s mode and available buyAssets routes.
A new buy without access returns 403 product_not_enabled before funds are
reserved. Existing holdings remain visible and can still be sold through
supported routes. An accepted purchase continues if access changes while it is
processing.
These restrictions apply to Ground API purchases and new API-managed gtoken
admissions. Previously allowlisted addresses retain their onchain permissions;
onchain deposits made directly from those addresses remain possible.
List assets without an API key
To display publicly visible yield sources and stocks, callGET /v2/public/yield-sources. No API key is required. Assets restricted to
specific organizations are excluded.
The response lists assets in data and includes generatedAt, the time the
catalog was loaded.
For organization-specific purchase access and supported routes, use
List portfolio assets.
Public asset fields
Display missing returns as unavailable, not zero. CETES returns are measured in
MXN; USD values also change with the exchange rate. See
CETES details
and Stock Tokens.
RWA
DeFi
Choose a funding asset
Useid as the yieldSourceId when creating a wallet or updating a strategy.
Check buyAssets for assets accepted by direct purchase routes and sellAssets
for assets returned by direct redemption routes. depositToken identifies the
default settlement stablecoin; other funding assets may be supported.
For automatic wallets, allocationGroup identifies the source’s strategy group.
See Allocation groups
for compatible funds and networks. For supported vaults,
fee wrappers let you add management or
performance fees to wallet positions.
Minimum allocation amounts vary by yield source. ground-uscc-vault requires
at least 1 USDC. The JAAA and JTRSY yield sources require at least 0.01 units of
their configured stablecoin. In sandbox, ground-jaaa-usdt-vault has a
per-wallet allocation cap of USD 1,000. The production source has no configured
cap. Check the live catalog and validate allocation amounts for your
organization.
Catalog fields
Each entry has a stable publicid, a kind, display metadata, and chain support.
Use buyAssets and sellAssets to find supported direct purchase and redemption
routes. Entries can also include the following fields:
How Ground RWA Vaults work
When you allocate to a Ground RWA Vault, your Portfolio Wallet holds a wallet-specific, non-transferable Ground receipt that tracks its position. The underlying provider instrument stays in the vault. See Onchain architecture for the routing and request, processing, and claim steps. Some actions settle immediately. Others wait for the provider to fulfill a request, the vault to process it, and the wallet to claim the result.processingPolicies and withdrawal previews provide operational processing
estimates. Actual completion depends on provider fulfillment and vault processing.
The Terms and Conditions of Lending govern
use of Ground RWA Vaults.
RWA details
Invesco Short Duration US Government Securities Fund tokenized by Superstate
Ground vaults
The Ground USTB vault issues a non-transferable Ground receipt to the Portfolio Wallet rather than transferring USTB to the wallet directly.
Superstate redemption facility
Superstate’s onchain USDC redemption facility (RedemptionIdle) exchanges USTB
for USDC at the provider’s redemption price, subject to the USDC available in
the facility. This is a liquidity pool for redeeming fund shares, not a market
sale of the wallet’s Ground receipt. Superstate describes onchain liquidity
as available for instant redemption where available.
The Ground vault checks the facility’s redeemable amount before exchanging
USTB. Its contract supports synchronous redemption when sufficient facility
liquidity is available. Portfolio Wallet withdrawals use an asynchronous
request, process, and claim workflow: the requested position is reserved,
processing redeems the underlying USTB, and the wallet claims USDC. Facility
liquidity enables the underlying exchange; it does not make every API
withdrawal complete instantly.
The catalog’s typical two-hour estimate is an operational estimate, not a
completion deadline. If liquidity is insufficient, settlement must wait for
available liquidity and processing. Use withdrawal previews and poll the
withdrawal or consume status-change webhooks until it completes.
Bitwise Crypto Carry Fund tokenized by Superstate
The Ground gUSCC vault provides exposure to crypto cash-and-carry, staking, and
U.S. Treasury strategies. The Portfolio Wallet holds a non-transferable Ground
receipt. Deposits and redemptions use an asynchronous request, process, and
claim workflow; submitted requests remain pending until provider fulfillment
and wallet settlement complete. Fund value can increase or decrease.
Put this source under
strategy.allocations.usdc. The effective minimum deposit
is 1 USDC. There is currently no configured catalog allocation cap in either
environment. Check maxAllocationUsd before allocating.
Superstate USTB on Solana
This sandbox source uses an asynchronous Ground vault on Solana devnet. Select
ground-solana-ustb-vault under strategy.allocations.usdc; the Ethereum source
ground-ustb-vault is a separate catalog entry. The Solana yield source follows
provider-operated settlement and does not use Ethereum’s onchain redemption
facility. Wait for the deposit or withdrawal workflow to complete before
using the settled position or USDC.
Janus Henderson JAAA tokenized by Centrifuge
Ground vaults
Your Portfolio Wallet holds a non-transferable Ground receipt for its JAAA
position. Deposits and redemptions complete after the provider fulfills the
request, the vault processes it, and the wallet claims the result. The position’s
net asset value (NAV) updates when the fund publishes a new value.
For an automatic wallet, put
ground-jaaa-usdc-vault under
strategy.allocations.usdc or ground-jaaa-usdt-vault under
strategy.allocations.usdt. Both sources are available in production and sandbox.
Janus Henderson JTRSY tokenized by Centrifuge
Ground vaults
Your Portfolio Wallet holds a non-transferable Ground receipt for its JTRSY
position. Choose the USDC or USDT source for your strategy’s funding asset.
USDC redemptions use Basin liquidity when available; otherwise both sources wait
for Centrifuge processing.
Neither source has a configured catalog cap in production or sandbox. Check
maxAllocationUsd in the live catalog before constructing a strategy.
Figure PRIME and Figure AUTO
PRIME provides exposure to a pool of home-equity lines of credit; AUTO provides
exposure to a pool of auto loans. Both can also hold cash equivalents. The
Portfolio Wallet holds the selected product’s SPL shares directly. These are
credit exposures: share value and returns depend on the underlying pool, and
NAV can increase or decrease.
Allocation and settlement
Put either source understrategy.allocations.usdc. Entry atomically converts
USDC through wYLDS into PRIME or AUTO shares. Share redemption converts the
selected shares into wYLDS, followed by a separate provider-managed redemption
from wYLDS to USDC. See Hastra’s Solana integration guide
for the provider redemption lifecycle.
Pending redemption value remains in the wallet total and the originating
product’s performance, but is unavailable for another withdrawal or allocation.
Receiving wYLDS does not mean the USDC withdrawal is complete. Poll the
withdrawal or consume status-change webhooks until it completes.
For USDC settlement, processingPolicies.redeem.processingTimeBasis is
"provider_managed". The API returns
processingEstimate and maximum as null for this basis. Display the settlement estimate as unavailable. Wait for the withdrawal to
complete before treating the USDC as available.
Rate and availability
The catalog returns a signed 30-day realized APY when enough fresh price history exists; otherwiseapyBps is null. A negative rate indicates a decline
over that observation period. This historical return is not a promised rate
and can differ from the provider’s displayed rate when the observation windows
differ. utilizationPct is null.
Fetch the live environment catalog before constructing a strategy. Dormant or
halted sources are not selectable for new allocations; existing positions
remain visible and can enter the redemption workflow, subject to provider
liquidity and processing.
Etherfuse Mexican Treasuries (CETES)
Etherfuse CETES is available only to eligible non-US users. Ground must enable purchases for your organization.
Use USDC on the catalog entry’s Stellar network to buy or redeem CETES through
its
buyAssets and sellAssets routes. For an automatic wallet, allocate to
etherfuse-cetes-stellar under strategy.allocations.usdc.
A purchase moves USDC into a pending claim until CETES delivery is confirmed.
Your wallet then holds CETES directly in positions. Automatic wallets also
show its USDC strategy target in strategyAllocations.
CETES returns are measured in Mexican pesos (MXN). Catalog and position apyBps
report the historical 30-day annualized return, with
denominationCurrency: "MXN". If the local rate is unavailable, apyBps is
null; display it as unavailable.
The USD value can fall even when the MXN return is positive. Wallet balances,
earnings, portfolio performance, and risk metrics are measured in USD and include
exchange-rate movements. Wallet-level APY is unavailable while CETES is held.
See Displaying yield.
DeFi details
Maple Syrup USDC
Syrup USDC is an overcollateralized lending product from Maple Finance. Withdrawals can be queue-based depending on protocol liquidity.
Maple Syrup USDT
Syrup USDT currently has no configured catalog cap in production or sandbox. Check
maxAllocationUsd in the live catalog for your organization.
Morpho Gauntlet USDC Prime
This source allocates into Morpho’s Gauntlet USDC Prime ERC-4626 vault. Ground values the position from onchain
convertToAssets() reads.
Morpho Steakhouse USDC Prime
This source allocates into Morpho’s Steakhouse USDC Prime ERC-4626 vault.
Morpho August USDC V2
This source allocates into Morpho’s August USDC V2 ERC-4626 vault.
Morpho Smokehouse USDC
This source holds an ERC-4626 vault position. Put
morpho-smokehouse-usdc under
strategy.allocations.usdc. Valuation uses the vault’s onchain asset-per-share
conversion; withdrawal liquidity depends on the vault’s available assets.
Morpho Gauntlet USDC Prime (Base)
This source holds an ERC-4626 vault position. Put
morpho-gauntlet-usdc-base under
strategy.allocations.usdc. Valuation uses the vault’s onchain asset-per-share
conversion; withdrawal liquidity depends on the vault’s available assets.
Morpho Steakhouse Prime USDC (Base)
This source holds an ERC-4626 vault position. Put
morpho-steakhouse-usdc-base under
strategy.allocations.usdc. Valuation uses the vault’s onchain asset-per-share
conversion; withdrawal liquidity depends on the vault’s available assets.
Kamino Allez USDC
Kamino Allez USDC is a Solana-native USDC vault curated by Allez.
Kamino Gauntlet USDC Frontier
This Kamino kvault is curated under Gauntlet’s Frontier mandate.
Kamino RockawayX RWA USDC
This Kamino lending vault is curated by RockawayX with a focus on real-world asset exposure.
Kamino Steakhouse USDC
This Kamino kvault is curated by Steakhouse Financial.
Kamino Superstate USDC
Your wallet supplies a Kamino lending reserve backed by Superstate collateral.
Aave V3 Core USDC
Ground represents Aave positions as scaled aUSDC units and values them from Aave V3 reserve normalized income.
JustLend V1 USDT
Ground supplies USDT to JustLend V1 and the Portfolio Wallet holds jUSDT receipt tokens. The position is valued using JustLend’s accrued share-to-USDT exchange rate. The catalog shows 100% exposure to the JustLend V1 USDT market; it is not a breakdown of individual borrowers or their collateral.
JustLend’s lending rate is variable, not a fixed promised return.
currentApy follows the published supply-rate convention, excluding reward-token incentives: 365-day annualization at the target three-second block interval, without an extra compounding step, truncated to whole basis points. Display it as Current APY only until validUntil. Historical apyBps remains separate and may be null until sufficient fresh 30-day history exists. Sampling times can cause brief differences from the provider page.
Deposits and redemptions settle onchain without a provider-managed redemption queue. Completion still depends on transaction confirmation, available market liquidity, and protocol controls. Use withdrawal previews and final workflow status rather than treating an “instant” estimate as guaranteed settlement.
Sandbox uses valueless Shasta test USDT and a simulated JustLend market. It exercises the same API flow but does not reproduce mainnet interest rates, liquidity, or market risk. See Supported Chains and Deposits.
Display returns
Catalog and wallet-positionapyBps report the annualized 30-day return in
denominationCurrency, expressed in basis points. For example, apyBps: 500
means 5% APY. If the value is null, display the rate as unavailable. Rates are
variable and describe historical returns.
Each source uses the following price or rate data:
- For USD sources in production,
apyBpsuses a fresh Ground-calculated 30-day rate when available, then a fresh official provider rate. - USTB and USCC use trailing rates derived from discrete provider NAV publications.
- JAAA and JTRSY use Centrifuge’s annualized seven-day and compounded 30-day yield snapshots.
- Figure PRIME and AUTO use signed annualized 30-day realized returns from discrete share-price history.
- Syrup uses Maple’s rate feed.
- Morpho vaults use trailing rates derived from ERC-4626 NAV/share history.
- Aave V3 uses reserve normalized income for valuation and trailing rates.
- JustLend V1 uses its accrued jUSDT exchange rate for valuation and historical rates;
currentApyis a separate, expiring current supply-rate preview. Do not substitute it for a wallet’s historical blended performance. - Kamino sources use trailing rates derived from onchain share prices or collateral exchange rates.
- CETES uses stored MXN token-price history for its denomination APY. Dollar earnings reports and risk metrics retain USD returns. Wallet-level APY is unavailable while non-USD investments are held.
Show when prices were updated
UsepriceAsOf on wallet yield positions to show when the reference price was
observed. Sources such as USTB, USCC, JAAA, JTRSY, PRIME, and AUTO update their
net asset value (NAV) when the provider publishes a new value; they return
navUpdateMode: "discrete". Continuously accruing onchain sources return
navUpdateMode: "continuous".
protocol
Estimate withdrawal timing
Use the source’sprocessingPolicies to explain typical deposit and redemption
timing. For a specific wallet, call POST /v2/wallets/{id}/withdrawal-preview.
Estimates depend on provider processing and available liquidity; wait for the
withdrawal to complete before treating the payout as available.
Each catalog row exposes action-specific deposit and redeem policies:
processingTimeBasis: "elapsed_seconds"describes ordinary elapsed time.processingTimeBasis: "banking_days"describes calendar-aware settlement, such as JAAA and JTRSY.processingTimeBasis: "provider_managed"describes Figure USDC settlement;processingEstimateandmaximumarenull, and completion depends on provider processing and available liquidity.typicalMinUnitsandtypicalMaxUnitsdescribe the typical range in that basis.processingEstimate, when present, resolves the policy into durations or dates at request time.
POST /v2/wallets/{id}/withdrawal-preview for wallet-specific withdrawal estimates. Actual completion depends on provider processing and available liquidity.
Coming Soon
These are yield sources Ground has not yet integrated but is tracking for future support.Aave USDT
Aave USDT is the USDT version of Aave’s Ethereum lending market, offering variable yield with withdrawals limited by pool liquidity and collateral constraints.
OpenTrade XHYC
XHYC is backed by a short-duration high-yield corporate bond ETF and targets higher credit yield without a fixed lockup.
OpenTrade XRV+
XRV+ is OpenTrade’s higher-yield rates product family focused on assets such as commercial paper and commodities trade finance.
Ondo OUSG
OUSG is Ondo’s tokenized U.S. Treasury product for institutional cash management with around-the-clock mint and redemption rails.
JitoSOL
JitoSOL keeps Solana staking exposure liquid and DeFi-usable while earning staking and MEV-linked rewards.
dSOL
dSOL is Drift’s liquid staking token for use across Drift’s trading and borrow-lend product surface.
stETH
stETH is Lido’s liquid version of staked ETH, preserving staking exposure while remaining usable across DeFi.
Katana vbUSDC yVault
Katana’s vbUSDC vault makes bridged USDC productive through the network’s Vault Bridge model.
Katana vbUSDT yVault
Katana’s vbUSDT vault is the USDT counterpart to vbUSDC, packaging bridged stablecoin liquidity into a yield-bearing vault.
Discover yield sources and Ondo stock tokens together with List portfolio assets. For Ondo stock details, see Stock Tokens.