Skip to main content
GET
/
v2
/
wallets
/
risk
/
metrics
List Risk Metrics
curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/risk/metrics \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "portfolioWalletId": "11111111-1111-4111-8111-111111111111",
      "yieldSourceId": "44444444-4444-4444-8444-444444444444",
      "observations": [
        {
          "portfolioWalletId": "11111111-1111-4111-8111-111111111111",
          "yieldSourceId": "44444444-4444-4444-8444-444444444444",
          "metrics": {
            "apy_bps": 482,
            "tvl_usd": 1240000000,
            "available_withdrawal_liquidity_usd": 180000000
          },
          "protocol": "syrup",
          "source": "yield_monitor",
          "recordedAt": "2026-06-02T16:00:00.000Z"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Query Parameters

portfolioWalletIds
string<uuid>[]

Optional repeatable or comma-separated portfolio wallet IDs.

yieldSourceIds
string<uuid>[]

Optional repeatable or comma-separated yield source row IDs.

metrics
enum<string>[]

Optional comma-separated metric filter. Defaults to all global risk metrics.

Global risk metric currently supported across yield sources.

Available options:
apy_bps,
tvl_usd,
available_withdrawal_liquidity_usd
startAt
string<date-time>

Include observations recorded at or after this timestamp.

endAt
string<date-time>

Include observations recorded at or before this timestamp.

latestOnly
boolean
default:true

When true, return the latest observation per yield source.

limitPerYieldSource
integer
default:100

Maximum observations to return per wallet/yield-source pair when latestOnly is false.

Required range: 1 <= x <= 100

Response

Risk metric observations

data
object[]