Get started

Objects

Wallet risk

A risk read of one wallet: every yield position it holds, scored against the latest daily screen, with exposure, what needs attention and an overview of everything else in the wallet.

Object: wallet_risk

Fields

Read-only: balances come from public chain data at read_at and are cached for 10 minutes per address; instrument data comes from the daily screen (as_of). Works for EVM addresses, ENS names and Solana addresses.

Positions are deposits (receipt tokens and vault positions), Aave V3 and Spark loans, Morpho markets, Uniswap v3 liquidity and Pendle fixed-rate positions. Only positions in screened instruments count in the wallet score; loans are read by their health factor and liquidity positions are not screened.

holdings covers the rest: native coins and plain tokens that earn nothing, yield-bearing tokens outside our screen, balances under $1, and counts of unrecognised tokens and NFTs. On most chains every token is listed; on the others (holdings.discovery.tracked_only) the native coin and the tokens we track. holdings never changes the score.

Example
{
  "object": "wallet_risk",
  "address": "0x99e65176F7FA8743E3fbaEF277d1Da448e361367",
  "chain_family": "evm",
  "ens_name": null,
  "chains_scanned": [
    "ethereum",
    "base",
    "arbitrum",
    "op-mainnet",
    "polygon",
    "bsc",
    "avalanche",
    …
  ],
  "as_of": "2026-10-24T15:42:33.943Z",
  "read_at": "2026-10-24T17:04:21.985Z",
  "coverage": {
    "instruments_checked": 7311,
    "chains_unavailable": [],
    "sources_unavailable": [],
    "truncated": [],
    "note": "Covers tokens held directly by this address on 27 EVM chains (lending deposits, liquid staking tokens, vault shares, savings tokens, idle stablecoins), plus Aave V3 and Spark borrows with their health factor, Morpho markets and vaults, Uniswap v3 liquidity NFTs and Pendle PT, YT and LP positions. Not covered yet: other borrow and liquidity protocols, tokens staked in another contract, and non-EVM chains other than Solana."
  },
  "totals": {
    "value": 248725.85,
    "earning": 248725.85,
    "idle": 0,
    "other": 0,
    "debt": 0
  },
  "score": 53,
  "band": "high",
  "positions": [
    {
      "id": "wpos_22c5fa21ed20eb10",
      "asset": "GTUSDCP",
      "label": "GTUSDCP on Morpho Blue",
      "kind": "deposit",
      "instrument": {
        "object": "instrument",
        "id": "ins_14bfecce8ad77117",
        "name": "GTUSDCP",
        "detail": "Gauntlet USDC Prime",
        …
      },
      "protocol": {
        "id": "prt_morpho-blue",
        "name": "Morpho Blue"
      },
      "chain": "base",
      "value": 99403.05,
      "share_of_wallet": 0.3996,
      "screened": true
    },
    …
  ],
  "idle": [],
  "holdings": {
    "discovery": {
      "full": ["ethereum", "op-mainnet", "gnosis", "scroll", …],
      "tracked_only": ["base", "arbitrum", "polygon", …]
    },
    "not_earning": [
      {
        "chain": "base",
        "kind": "native",
        "asset": "ETH",
        "name": "Ether",
        "token": null,
        "amount": 0.42,
        "value": 981.12,
        "asset_class": "ether"
      },
      …
    ],
    "not_covered": [
      {
        "chain": "base",
        "kind": "token",
        "asset": "wrsETH",
        "name": null,
        "token": "0xedfa23602d0ec14714057867a78d01e94176bea0",
        "amount": 0.1,
        "value": 245.3,
        "asset_class": "ether",
        "yield_hint": "known_yield_token",
        "protocol": "Kelp"
      }
    ],
    "small": {
      "count": 3,
      "value": 1.12,
      "items": […]
    },
    "unrecognized": {
      "count": 12
    },
    "nfts": {
      "count": 2
    },
    "suggestions": [
      {
        "asset_class": "ether",
        "idle_value": 981.12,
        "alternatives": […]
      }
    ],
    "totals": {
      "wallet": 249953.39,
      "not_earning": 981.12,
      "not_covered": 245.3,
      "small": 1.12
    }
  },
  "exposure": {
    "by_protocol": [
      {
        "id": "prt_morpho-blue",
        "name": "Morpho Blue",
        "share": 1,
        "value": 248725.85
      }
    ],
    "by_chain": [
      {
        "id": "base",
        "name": "Base",
        "share": 1,
        "value": 248725.85
      }
    ],
    "by_asset_class": [
      {
        "asset_class": "stablecoin",
        "share": 1,
        "value": 248725.85
      }
    ]
  },
  "alerts": [
    {
      "severity": "critical",
      "code": "failed_screen",
      "instrument_id": "ins_227e8fb041157106",
      "position_id": "wpos_2b2d522778be9fcc",
      "rule": "tvl_floor",
      "title": "BBQUSDC on Morpho Blue (Base) failed our screen",
      "detail": "$42K (17% of this wallet) is in an instrument our methodology excludes: its total value locked is below the $50M floor."
    },
    …
  ],
  "comparisons": [
    {
      "for_instrument_id": "ins_227e8fb041157106",
      "alternatives": [
        {
          "object": "instrument",
          "id": "ins_f3cbaa85fd31098b",
          "name": "USD1",
          …
        }
      ]
    },
    …
  ],
  "access": "full",
  "disclaimer": "Yield Sniper data is research, not financial advice. Balances are read from public blockchain data; values are estimates from the latest daily screen."
}