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",
  "minApyTargetBps": 500,
  "liquidityConstraints": [
    {
      "maxProcessingTime": "P1D",
      "minWeightBps": 5000
    }
  ],
  "yieldSourceTypes": [
    "<string>"
  ],
  "exclusions": [
    "<string>"
  ],
  "withdrawalDestination": {
    "destinationChain": "ethereum",
    "destinationToken": "usdc"
  }
}
'
[
  {
    "strategyConfig": {
      "positions": [
        {
          "positionKey": "syrup-usdc",
          "targetWeightBps": 7000,
          "maxProcessingTime": "P7D",
          "currentApy": 850
        },
        {
          "positionKey": "aave-usdc",
          "targetWeightBps": 3000,
          "maxProcessingTime": "PT1H",
          "currentApy": 350
        }
      ]
    },
    "blendedRateBps": 700,
    "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"

​
minApyTargetBps
integer | null

Minimum blended APY target in basis points. The engine will prefer allocations that meet or exceed this threshold.

Required range: x >= 0
Example:

500

​
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

Array of recommended strategy options

​
strategyConfig
object
​
blendedRateBps
number

Blended APY across all positions in basis points.

​
constraintsSatisfied
boolean

Whether all liquidity constraints were met.

​
withdrawalTimeEstimates
object

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