curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/strategy/optimize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "allocations": {
    "usdc": [
      {
        "yieldSourceId": "morpho-august-usdc-v2",
        "pct": 100
      }
    ]
  },
  "summary": {
    "blendedApyBps": 560,
    "sourceCount": 1,
    "protocolCount": 1,
    "liquidityProfile": {
      "atomic": 100
    }
  },
  "sources": [
    {
      "yieldSourceId": "morpho-august-usdc-v2",
      "pct": 100,
      "apyBps": 560,
      "protocol": "morpho",
      "chain": "ethereum",
      "processingPolicy": {
        "processingTimeBasis": "elapsed_seconds",
        "typicalMinUnits": 0,
        "typicalMaxUnits": 0
      }
    }
  ]
}

Yield Sources

Optimize wallet strategy

Returns a yield-maximizing allocation that satisfies the supplied constraints. The optimizer considers only sources whose depositToken matches the requested token. All request fields are optional; token defaults to usdc, so an empty body returns 100% to the highest-APY active USDC source. The token-keyed allocations object has the same shape as strategy.allocations on POST /v2/wallets, so callers can chain it directly into wallet creation.

When the best achievable allocation fails to satisfy minBlendedApyBps, the endpoint still returns 200 with the best-effort allocation and a top-level unmetConstraints: ["minBlendedApyBps"] field. Other infeasibility cases (no eligible sources, caps prevent full allocation) return 422.

POST

/

v2

/

wallets

/

strategy

/

optimize

curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets/strategy/optimize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "allocations": {
    "usdc": [
      {
        "yieldSourceId": "morpho-august-usdc-v2",
        "pct": 100
      }
    ]
  },
  "summary": {
    "blendedApyBps": 560,
    "sourceCount": 1,
    "protocolCount": 1,
    "liquidityProfile": {
      "atomic": 100
    }
  },
  "sources": [
    {
      "yieldSourceId": "morpho-august-usdc-v2",
      "pct": 100,
      "apyBps": 560,
      "protocol": "morpho",
      "chain": "ethereum",
      "processingPolicy": {
        "processingTimeBasis": "elapsed_seconds",
        "typicalMinUnits": 0,
        "typicalMaxUnits": 0
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Body

application/json

token

enum<string>

default:usdc

Stablecoin strategy lane to optimize. Only yield sources with a matching depositToken are eligible.

Available options:

usdc,

usdt

minBlendedApyBps

integer

Minimum blended APY floor in basis points. If the best achievable allocation falls below this floor, the response still returns 200 and includes unmetConstraints with the entry minBlendedApyBps.

Required range: 0 <= x <= 10000

liquidity

object

Show child attributes

concentration

object

Show child attributes

allowedChains

string[]

Restrict eligible sources to the listed chains (e.g., ["ethereum", "base"]). Omit to allow all chains.

Minimum array length: 1

excludedSources

string[]

Yield source IDs to exclude. Match by the kebab-case id returned from GET /v2/wallets/yield-sources.

excludedProtocols

string[]

Protocol slugs to exclude. Case-insensitive.

maxSources

integer

Cap on the number of distinct sources used in the allocation.

Required range: x >= 1

Response

Optimal (or best-effort) allocation

allocations

object

required

Token-keyed allocation percentages summing to exactly 100 within the requested token lane. Shape matches the strategy.allocations input on POST /v2/wallets.

Show child attributes

summary

object

required

Show child attributes

sources

object[]

required

Per-allocation detail for UI rendering.

Show child attributes

unmetConstraints

enum<string>[]

Present only when the best-achievable allocation fails to satisfy one or more non-hard constraints. Absent when all constraints are met.

Available options:

minBlendedApyBps

List yield sources List deposits