Endpoints · Wallets

Public wallet check

The same check without a key, as on the public wallet check page.

GET/api/v1/wallet-check

Public, no key

Parameters

Request
curl -G https://yieldsniper.finance/api/v1/wallet-check \
  -d address=0x99e65176f7fa8743e3fbaef277d1da448e361367
Response200
{
  "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": "preview",
  "disclaimer": "Yield Sniper data is research, not financial advice. Balances are read from public blockchain data; values are estimates from the latest daily screen."
}

Returns