Skip to main content
POST
/
v2
/
wallets
/
quote
Get strategy quote
curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "minApyTargetPct": 5,
  "liquidityConstraints": [
    {
      "maxProcessingTime": "P1D",
      "minWeightPct": 50
    }
  ],
  "yieldSourceTypes": [
    "<string>"
  ],
  "exclusions": [
    "<string>"
  ],
  "withdrawalDestination": {
    "destinationChain": "ethereum",
    "destinationToken": "usdc"
  }
}
'
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "positions": [
    {
      "yieldSourceId": "syrup-usdc",
      "yieldSourceType": "overcollateralizedLending",
      "asset": "usdc",
      "weightPct": 70,
      "currentRatePct": 8.5,
      "maxProcessingTime": "P7D"
    },
    {
      "yieldSourceId": "usdz",
      "yieldSourceType": "stablecoinYield",
      "asset": "usdz",
      "weightPct": 30,
      "currentRatePct": 3.3,
      "maxProcessingTime": "PT0H"
    }
  ],
  "blendedRatePct": 6.94,
  "constraintsSatisfied": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
requestId
string<uuid>
required

Idempotency key for the quote request.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
minApyTargetPct
number | null

Minimum blended APY target as a percentage (e.g. 5.0 = 5%). The engine will prefer allocations that meet or exceed this threshold.

Required range: x >= 0
Example:

5

​
liquidityConstraints
object[] | null

Liquidity constraints the allocation should satisfy (e.g. minimum weight within a processing-time cap).

​
yieldSourceTypes
string[] | null

Restrict to these yield source types (e.g. lending, staking). If omitted, all types are eligible.

​
exclusions
string[] | null

Yield source IDs to exclude from consideration.

​
withdrawalDestination
object

If provided, the response includes per-position withdrawal time estimates for the given destination.

Response

Recommended portfolio allocation

​
requestId
string<uuid>

Echo of the request ID.

​
positions
object[]
​
blendedRatePct
number

Blended APY across all positions as a percentage.

​
constraintsSatisfied
boolean

Whether all liquidity constraints were met.

​
withdrawalTimeEstimates
object

Per-position withdrawal time estimates (only present when withdrawalDestination was provided).