Skip to main content

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.

Yield sources are the underlying strategies a portfolio wallet can allocate into. A wallet strategy is a weighted allocation across one or more yield sources. Each source has a stable public id, display metadata, chain support, risk metadata, current rate information, and optional market context such as TVL, vault-level utilization, protocol addresses, vault links, and top underlying allocations when provider data is available.

Available yield sources

Fetch the live catalog with GET /v2/wallets/yield-sources:
curl -X GET "$BASE_URL/v2/wallets/yield-sources" \
  -H "Authorization: Bearer $API_TOKEN"
{
  "yieldSources": [
    {
      "id": "syrup-usdc",
      "name": "Syrup USDC",
      "description": "USDC lending through Maple Finance's Syrup protocol.",
      "apyBps": 418,
      "protocol": "maple",
      "estimatedWithdrawalTime": "PT24H",
      "expectedProcessingTime": "PT12H",
      "tvlUsd": 1200000000,
      "utilizationPct": 82.5,
      "addresses": [
        {
          "label": "Pool",
          "value": "0x80ac24aa929eaf5013f6436cda2a7ba190f5cc0b"
        }
      ],
      "links": [
        {
          "label": "Maple earn",
          "url": "https://maple.finance/syrup"
        }
      ],
      "allocations": [
        {
          "label": "Open-term loans",
          "type": "loan",
          "valueUsd": 540000000,
          "pct": 45
        }
      ]
    },
    {
      "id": "morpho-gauntlet-usdc",
      "name": "Morpho Gauntlet USDC Prime",
      "description": "Overcollateralized lending via a Morpho ERC-4626 USDC vault.",
      "apyBps": 472,
      "protocol": "morpho",
      "estimatedWithdrawalTime": "PT0H",
      "expectedProcessingTime": "PT0H",
      "tvlUsd": 400000000,
      "utilizationPct": 59,
      "addresses": [
        {
          "label": "Vault",
          "value": "0xdd0f28e19C1780eb6396170735D45153D261490d"
        }
      ],
      "links": [
        {
          "label": "Morpho vault",
          "url": "https://app.morpho.org/ethereum/vault/0xdd0f28e19C1780eb6396170735D45153D261490d/gauntlet-usdc-prime"
        }
      ],
      "allocations": [
        {
          "label": "USDC / cbBTC",
          "type": "market",
          "valueUsd": 220000000,
          "pct": 55
        },
        {
          "label": "USDC / WETH",
          "type": "market",
          "valueUsd": 180000000,
          "pct": 45
        }
      ]
    },
    {
      "id": "morpho-steakhouse-usdc",
      "name": "Morpho Steakhouse USDC Prime",
      "description": "Overcollateralized lending via a Morpho ERC-4626 USDC vault.",
      "apyBps": 468,
      "protocol": "morpho",
      "estimatedWithdrawalTime": "PT0H",
      "expectedProcessingTime": "PT0H",
      "tvlUsd": 350000000,
      "utilizationPct": 63,
      "addresses": [
        {
          "label": "Vault",
          "value": "0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB"
        }
      ],
      "links": [
        {
          "label": "Morpho vault",
          "url": "https://app.morpho.org/ethereum/vault/0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB/steakhouse-usdc-prime"
        }
      ],
      "allocations": [
        {
          "label": "USDC / wstETH",
          "type": "market",
          "valueUsd": 210000000,
          "pct": 60
        },
        {
          "label": "USDC / WBTC",
          "type": "market",
          "valueUsd": 140000000,
          "pct": 40
        }
      ]
    },
    {
      "id": "kamino-gauntlet-frontier-usdc",
      "name": "Kamino Gauntlet USDC Frontier",
      "description": "Solana USDC yield via a Kamino kvault curated by Gauntlet.",
      "apyBps": 612,
      "protocol": "kamino",
      "estimatedWithdrawalTime": "PT0H",
      "expectedProcessingTime": "PT0H",
      "tvlUsd": 240000000,
      "utilizationPct": 71,
      "addresses": [
        {
          "label": "Vault",
          "value": "GFiW6edsrtHZd4Vnz2qTSurVasRrgKrXE1ouHNtCVsft"
        },
        {
          "label": "Shares mint",
          "value": "7oPz5dFNUgVtWNChqJW4ud8fhECVq5m75BN1t4WMLpxA"
        },
        {
          "label": "kVault program",
          "value": "KvauGMspG5k6rtzrqqn7WNn3oZdyKqLKwK2XWQ8FLjd"
        }
      ],
      "links": [
        {
          "label": "Kamino vault",
          "url": "https://kamino.com/earn/lend/gauntlet-usdc-frontier/vault-overview"
        }
      ],
      "allocations": [
        {
          "label": "USDC / Main",
          "type": "reserve",
          "valueUsd": 168000000,
          "pct": 70,
          "description": "Target reserve allocation"
        },
        {
          "label": "USDC / JLP",
          "type": "reserve",
          "valueUsd": 72000000,
          "pct": 30,
          "description": "Target reserve allocation"
        }
      ]
    },
    {
      "id": "kamino-superstate-usdc",
      "name": "Kamino Superstate USDC",
      "description": "Solana USDC yield via a Kamino klend reserve backed by Superstate.",
      "apyBps": 585,
      "protocol": "kamino",
      "estimatedWithdrawalTime": "PT0H",
      "expectedProcessingTime": "PT0H"
    }
  ]
}
Example APYs and market context values above are illustrative. Always use GET /v2/wallets/yield-sources for the current live catalog and rates.
The catalog is environment-specific. Sandbox only exposes the subset that is currently wired for sandbox execution. Do not hard-code yield source IDs by environment; always fetch the live catalog before creating or updating a strategy.
Yield source IDLiquidityDescription
syrup-usdcTypically within 24h (PT24H)Overcollateralized USDC lending via Maple Finance’s Syrup.
morpho-gauntlet-usdcInstant (PT0H)ERC-4626 lending vault exposure via Morpho’s Gauntlet USDC Prime vault.
morpho-steakhouse-usdcInstant (PT0H)ERC-4626 lending vault exposure via Morpho’s Steakhouse USDC Prime vault.
kamino-allez-usdcInstant (PT0H)Solana USDC yield via a Kamino kvault curated by Allez.
kamino-gauntlet-frontier-usdcInstant (PT0H)Solana USDC yield via a Kamino kvault curated by Gauntlet (Frontier).
kamino-rockawayx-rwa-usdcInstant (PT0H)Solana USDC yield via a Kamino kvault curated by RockawayX (RWA).
kamino-steakhouse-usdcInstant (PT0H)Solana USDC yield via a Kamino kvault curated by Steakhouse Financial.
kamino-superstate-usdcInstant (PT0H)Solana USDC yield via a Kamino klend reserve collateralized by Superstate.
Use id as the yieldSourceId when creating a wallet or updating a strategy. Catalog rows may also include optional market context for richer source displays:
FieldDescription
tvlUsdCurrent source TVL in USD when provider data is available.
utilizationPctVault-level deployed-asset utilization percentage when provider data is available.
addresses[]Protocol addresses relevant to the source.
links[]Provider UI links for the source.
allocations[]Current underlying allocation rows. Percentages describe source asset mix, not utilization.

Yield source details

Syrup USDC

Yield source IDsyrup-usdc
TypeOvercollateralized lending
ChainEthereum
LiquidityTypically within 24 hours
Syrup USDC is an overcollateralized lending product from Maple Finance. Deposits and withdrawals are handled through an ERC-4626 vault, but withdrawals can still be queue-based depending on protocol liquidity.

Morpho Gauntlet USDC Prime

Yield source IDmorpho-gauntlet-usdc
TypeOvercollateralized lending
ChainEthereum
LiquidityInstant
This source allocates into the Morpho Gauntlet USDC Prime ERC-4626 vault. Ground values the position from onchain convertToAssets() reads and computes the displayed APY from trailing NAV/share history.

Morpho Steakhouse USDC Prime

Yield source IDmorpho-steakhouse-usdc
TypeOvercollateralized lending
ChainEthereum
LiquidityInstant
This source allocates into the Morpho Steakhouse USDC Prime ERC-4626 vault. It shares the same portfolio-wallet mechanics as Gauntlet but tracks a separate underlying Morpho vault.

Kamino Allez USDC

Yield source IDkamino-allez-usdc
TypeCurated kvault (Solana)
ChainSolana
LiquidityInstant
Kamino Allez USDC is a Solana-native USDC yield vault curated by Allez on Kamino. Allocations are held as kvault shares; Ground values the position from the onchain share price and unwinds via Kamino’s kvault withdraw path.

Kamino Gauntlet USDC Frontier

Yield source IDkamino-gauntlet-frontier-usdc
TypeCurated kvault (Solana)
ChainSolana
LiquidityInstant
A Kamino kvault curated by Gauntlet’s Frontier mandate. USDC deposits are routed across Kamino reserves selected by the curator; yield and NAV are derived from onchain share pricing.

Kamino RockawayX RWA USDC

Yield source IDkamino-rockawayx-rwa-usdc
TypeCurated kvault (Solana, RWA-tilted)
ChainSolana
LiquidityInstant
A Kamino kvault curated by RockawayX with a real-world-asset tilt. Same portfolio-wallet mechanics as other Kamino kvaults; the strategy mix differs.

Kamino Steakhouse USDC

Yield source IDkamino-steakhouse-usdc
TypeCurated kvault (Solana)
ChainSolana
LiquidityInstant
A Kamino kvault curated by Steakhouse Financial. Accepts USDC deposits, issues share tokens, and yields through Kamino’s lending markets as directed by the curator.

Kamino Superstate USDC

Yield source IDkamino-superstate-usdc
TypeKamino klend reserve (Superstate-collateralized)
ChainSolana
LiquidityInstant
Superstate USDC is a Kamino klend reserve directly (rather than a curated kvault). Supplies liquidity against Superstate-backed collateral; unwinds call the reserve’s redeem_reserve_collateral path. Position value is derived from the reserve’s current collateral exchange rate.

Rate semantics

  • apyBps is an annualized yield figure in basis points.
  • syrup-usdc uses Maple’s Syrup rate feed.
  • Morpho ERC-4626 vaults exposed by the live catalog use trailing APR derived from ERC-4626 NAV/share history.
  • Kamino kvaults and klend reserves use trailing APR derived from Kamino’s onchain share price / collateral exchange rate history.
  • All rates are variable and may change over time.
  • syrup-usdc is valued from an onchain ERC-4626 convertToAssets() read.
  • Morpho ERC-4626 vaults exposed by the live catalog are also valued from onchain ERC-4626 convertToAssets() reads.
  • Kamino kvaults are valued from the onchain share price (shareValueInAssets) read via Kamino’s kvault SDK.
  • Kamino klend reserves (e.g. Superstate) are valued from the reserve’s onchain collateralExchangeRate.

protocol

protocol is a lowercase slug identifying the issuer or curating protocol for the yield source. Multiple yield sources can share the same protocol (e.g. all Morpho vaults have "protocol": "morpho").
ValueProtocol
morphoMorpho Labs
mapleMaple Finance
kaminoKamino Finance
resolvResolv
superstateSuperstate
Use protocol to apply protocol-level concentration limits in POST /v2/wallets/strategy/optimize.

estimatedWithdrawalTime

estimatedWithdrawalTime is an ISO 8601 duration representing the worst-case yield-source unwind time (SLA upper bound), also referred to as maxProcessingTime in the optimization API.
DurationMeaning
PT0HImmediate
PT24HUp to roughly 24 hours
Use POST /v2/wallets/:id/withdrawal-preview when you need wallet-specific withdrawal timing rather than source-level estimates.

expectedProcessingTime

expectedProcessingTime is an ISO 8601 duration representing the typical withdrawal completion time for a source — distinct from estimatedWithdrawalTime, which is the SLA upper bound. For sources with predictable queue-based settlement, the expected time may be shorter than the maximum.
DurationMeaning
PT0HTypically completes immediately
PT12HTypically completes within ~12 hours
PT24HTypically completes within ~24 hours

Coming Soon

These are yield sources we have not yet integrated into Ground, but are actively tracking for future support.

Aave USDC

TypeOvercollateralized lending
ChainEthereum
LiquidityVariable; withdrawals depend on available pool liquidity
Provider pageAave USDC reserve
Aave USDC is a large onchain lending market where USDC suppliers earn variable yield while retaining withdrawal access when reserve liquidity is available.

Aave USDT

TypeOvercollateralized lending
ChainEthereum
LiquidityVariable; withdrawals depend on available pool liquidity
Provider pageAave USDT reserve
Aave USDT is the USDT version of Aave’s Ethereum lending market, offering variable yield with withdrawals limited by pool liquidity and collateral constraints.

Superstate USTB

TypeTokenized US Treasury bills
ChainEthereum, Solana, Plume
LiquidityEach market day
Provider pageSuperstate USTB
USTB gives eligible investors tokenized exposure to short-duration US Treasury bills with subscriptions and redemptions facilitated in USD or USDC.

Superstate USCC

TypeTokenized crypto carry fund
ChainEthereum, Solana, Plume
LiquidityT+1 pricing, T+2 token or redemption settlement
Provider pageSuperstate USCC
USCC gives eligible investors tokenized exposure to a managed crypto basis and carry strategy rather than a simple cash-equivalent treasury fund.

OpenTrade XHYC (High Yield Corporate Bond Vault)

TypeETF-backed corporate credit
ChainAvalanche, Plume
LiquidityAnytime, repaid T+1
Provider pageOpenTrade High Yield Corporate Bond Vault
XHYC is an OpenTrade vault backed by a short-duration high-yield corporate bond ETF, aiming to offer higher credit yield without a fixed lockup.

OpenTrade XRV+ (Rates+ Vaults)

TypeStructured rates and private credit
ChainNot yet publicly disclosed on the provider page
LiquidityNot yet publicly disclosed on the provider page
Provider pageOpenTrade product suite
XRV+ is OpenTrade’s higher-yield rates product family focused on assets such as commercial paper and commodities trade finance rather than only short-term government paper.

Ondo OUSG

TypeTokenized US Treasuries
ChainEthereum, Solana, Polygon, XRPL
Liquidity24/7 instant mint and redemption
Provider pageOndo Nexus / OUSG liquidity overview
OUSG is Ondo’s flagship tokenized US Treasury product built for institutional-grade cash management with around-the-clock mint and redemption rails.

Etherfuse Bonds

TypeTokenized sovereign bonds
ChainSolana, Polygon, Stellar
LiquidityVaries by bond series and market venue
Provider pageEtherfuse Bonds
Etherfuse turns government bond exposure into onchain tokens such as USTRY, TESOURO, CETES, and other local-market bond series.

JitoSOL

TypeLiquid staking
ChainSolana
LiquidityLiquid token with secondary-market access and native unstake flows
Provider pageJitoSOL overview
JitoSOL lets users keep Solana staking exposure liquid and DeFi-usable while still earning staking and MEV-linked rewards.

dSOL

TypeLiquid staking
ChainSolana
LiquidityLiquid token within Drift’s trading and earn stack
Provider pageDrift v3 overview
dSOL is Drift’s liquid staking token, designed to stay usable as a yield-bearing asset across Drift’s trading and borrow-lend product surface.

stETH

TypeLiquid staking
ChainEthereum
LiquidityLiquid token with daily rebasing rewards and broad DeFi liquidity
Provider pageWhat is stETH?
stETH is Lido’s liquid version of staked ETH, letting users keep Ethereum staking exposure while continuing to use the asset across DeFi.

Katana vbUSDC yVault

TypeYield-bearing vault
ChainKatana
LiquidityOnchain vault liquidity
Provider pageKatana vbUSDC vault
Katana’s vbUSDC vault is built on the network’s Vault Bridge model to make bridged USDC productive as soon as it lands on Katana.

Katana vbUSDT yVault

TypeYield-bearing vault
ChainKatana
LiquidityOnchain vault liquidity
Provider pageKatana vbUSDT vault
Katana’s vbUSDT vault is the USDT counterpart to vbUSDC, packaging bridged stablecoin liquidity into a yield-bearing Katana vault.