Guides

Analyse a wallet

Balances plus a per-token risk screen, with an explicit ceiling when a check could not run.

GET/api/v1/wallet/{address}API key

Analyze a wallet

A wallet analysis screens the tokens it holds using the same scoring functions a single token analysis uses. A token judged inside a portfolio gets the same verdict it would get on its own.

Why only some positions are screened

Each position costs four explorer reads. An unbounded wallet would issue hundreds of requests and be rate-limited into returning nothing at all, so screening is capped at eight positions by default.

Reading a holding

facts.portfolio.holdings[]

{
  "address": "0x…",
  "symbol": "TKN",
  "value_usd": 1240.5,
  "score": 63,
  "level": "moderate",
  "is_upper_bound": true,
  "checks_run": ["supply", "verification"],
  "checks_missed": ["tradability"],
  "signals": [ … ],
  "explorer_url": "https://…"
}

is_upper_bound: true means a check was missed and the real score can only be lower than shown. score: null with level: "unscored" means nothing could be established at all — which is not the same as a zero.

Portfolio totals

total_holdings: Positions the wallet holds.
screened: How many were actually screened.
flagged: Screened positions carrying a risk signal.
unscored: Screened but nothing could be established.