Docs

How to read it,
and when it helps.

A visual guide to each view, what it shows, what it provides, and the real situations it's built for. Plus how ChainSpiral treats its data.

Getting started

ChainSpiral needs no install and no wallet. Open the app, pick the tokens you care about, and you instantly see, across chains, in real time, which protocols, markets and chains their money flows to, and where it's exposed. The main screen pairs a flow map in the center with real-time monitoring alerts on the right, so "what's happening" and "where" sit side by side.

The whole product is read-only and verification-first: every particle is a real on-chain transfer, and nothing that can't be resolved on-chain is invented. See Data honesty.

First thing you see: tokens flagged right now

The moment you open ChainSpiral, every active alert is rolled up into a single ranked strip, your risk shortlist for the day. Alerts are grouped by token; each token shows its highest current severity and how many alerts it carries, ordered critical-first then by count, so the most urgent token is always top-left. Each card carries the live price and 24h change. Click one to jump straight into that token's Relationship Map or Flow Map.

Tokens with a risk signal right now 6
Critical Warning Info
USR
USR
$0.1562 −3.03%
Critical 5
WBT
WBTC
$98,420 −1.34%
Warning 2
aUS
aUSD
$0.9607 +0.03%
Info 2
USD
USDe
$0.9782 −2.10%
Critical 3
crv
crvUSD
$0.9981 −0.40%
Warning
USD
USDC
$1.000 +0.01%
Info
The home-screen risk shortlist: active alerts collapsed into one card per token, tinted and ranked by severity. Click a card → pick Relationship Map or Flow Map for that token.

Clicking a token, whether from the shortlist above or any alert, opens a quick chooser. Take the Relationship Map to read its exposure and dependency structure, or the Flow Map to watch money move in real time. Either way you land already scoped to that token.

USR USR
How would you like to explore?
Relationship Map exposure & dependency
Flow Map real-time money flow
The explore chooser shown on clicking a token: Relationship Map (exposure & dependency structure) or Flow Map (real-time money flow), both pre-scoped to that token.

Flow Map: money in motion

The flow map draws the path of money as a graph: tokens → protocols → markets / vaults, joined across chains by bridges. Real transfers (last 30 minutes) ride the edges as particles, so you literally watch deposits, swaps and withdrawals move.

stETH aave-v3 curve uniswap morpho ⚠ vault wstETH token (selected, hub) protocol risk node (NAV oracle) ● particle = a real transfer
Live flow: stETH deposited into aave / curve, swapped on uniswap, supplied to a flagged morpho market. Particle size = USD value, color = selected token.
token protocol market vault risk / NAV oracle relationship (dotted)

Two solid lanes on a flow edge = the two directions of flow (deposit vs. withdraw); a dotted line = a relationship only. Switch between Live 30 min (particles) and Baseline 24h (the normal per-edge inflow/outflow) to see what's unusual right now. Nodes with no measurement adapter get a dashed outline, "unmeasured", not "quiet".

What it provides

  • Token → protocol → market / vault paths across Ethereum, Base, Arbitrum
  • Live particles (last 30 min, 1 min delay) sized by USD, colored by token, split into deposit / withdraw lanes
  • A 24h baseline to compare normal flow against
  • Risk highlights (oracle dependence, self-referential NAV) by color & pulse
  • Drag-to-explore physics layout and a per-node / per-edge detail panel

When to use it

  • Spot a bank-run early, a token draining out of one protocol in real time
  • Track where fresh capital is flowing into a new market or vault
  • Confirm an alert: jump in and see “where & how” the move happened
  • Watch a depeg propagate hop by hop through deposits and swaps
  • Sanity-check that a protocol's reported TVL matches actual transfer activity

Monitoring: alerts, classified

Alerts are generated only from statistically meaningful changes in snapshot diffs, no raw noise. Each is graded critical / warning / info, tagged with token and chain, and clicking one deep-links into a flow map filtered to exactly that token and chain.

Real-time monitoring alerts
Critical Warning Info
USDeethereumDepeg2m ago
USDe $0.978, price deviation, NAV-market liquidation-lag risk
WBTCarbitrumLiquidity drop11m ago
aave-v3 WBTC available liquidity −38% (1h)
USDCbaseChain supply spike26m ago
base totalSupply +$33.4M USDC (robust z=12.4)
The alert panel as it appears beside the flow map. Click any row → a flow map scoped to that token & chain.

What it provides

  • 17+ alert types across three severities (critical / warning / info)
  • Chain & severity filters, sorted by event-observation time (no misleading lag)
  • One-click deep-link from every alert into the flow map
  • A floating mini alert dock visible on any screen, with a new-alert indicator
  • ~15s polling against the latest snapshots

When to use it

  • Early warning on a stablecoin depeg or a sudden liquidity drop in a market you hold
  • Catch bad-debt thresholds or utilization spikes on lending markets / curator vaults
  • Notice new collateral adoption or large unverified exposure as it appears
  • Hands-off overnight / weekend monitoring of a watchlist
  • Triage fast, severity + chain filters cut to what actually needs a response

Risk factors, scored: a yield-bearing watchlist

Yield-bearing dollars and staking derivatives are where reflexive-NAV pricing, thin backing and depegs concentrate, so it helps to see the riskiest side by side, sorted worst-first. Each is scored Low / Medium / High on five factors that map to live signals: peg stability (depeg), oracle design, liquidation cascade, backing & supply integrity, and exposure concentration (HHI). The thresholds below are the app's own backtested values.

Low Medium High
How each level is set
Peg — drifts past its normal band (hard stables ≈1.5%, yield/CDP dollars ≈5%, LSTs ≈2%) → Medium; a depeg of ≥8.5%High.
Oracle — a fixed / NAV price on a volatile asset, or a feed left stale past ~1.75× its heartbeat → High.
Liquidation — market utilization ≥98% (suppliers can't withdraw) or realized bad debt ≥$1MHigh; a sudden +15% utilization jump → Medium.
Backing & supply — supply grows +3% in one snapshot → Medium; +10%, or a single unauthorized ~10% mint → High.
Concentration — exposure spread (HHI) 0.25–0.5Medium; ≥0.5 (piled into one venue) → High.
Last updated: 2026-06-28 05:01 UTC · live snapshot
Token Peg Oracle Liquidation Backing Concentration
MSY High High High Low High
USR High Low High Low High
sUSDe Low High Medium Low High
bUSD0 Low High Low Low High
GHO Low Low High Low High
rsETH Low Low Medium Medium High
apxUSD High Low Low Low Medium
syrupUSDC Low Low Medium Low High
superOETHb Low Low Low Low High
wsuperOETHb Low High Low Low Low
yoUSD Low High Low Low Low
crvUSD Low Low Medium Low Medium
msETH Low Low Medium Low Medium
cbETH Low Low Low Low Medium
MAI Low Low Medium Low Low
rETH Low Low Low Low Medium
USDe Low Low Low Low Medium
wrsETH Low Low Medium Low Low
alUSD Low Low Low Low Low
FXUSD Low Low Low Low Low
A yield-bearing risk watchlist, sorted worst-first from live per-factor scores. USR is flagged critical (depeg + bad-debt); sUSDe, bUSD0, yoUSD and wsuperOETHb carry bespoke-NAV oracle risk. MSY is scored as of its 21 Jun depeg event (−70% spot, 100%-utilized single Morpho market); all other rows are current live values.

Relationship Map: where risk spreads

The relationship map arranges a token's exposure in concentric rings and overlays its money-lego derivative structure. It's not a holdings list, it's a dependency graph, so you can trace how a base asset is re-deposited as derivatives and how far a shock would reach.

sUSDe PT-sUSDe LP pendle curve morpho aave vault vault inner ring = base · outer rings = derivatives → re-deposits
sUSDe at the center; its money-lego chain: wrapped into PT / LP, then supplied to pendle, curve, morpho, aave and curator vaults.

What it provides

  • Money-lego overlay, derivative roles (PT, YT, LP, receipt, wrapper) along an unbroken chain
  • Exposure concentration: how much of a token sits in which protocol / market / chain
  • Oracle dependence per market (market, exchange-rate, NAV / self-referential), with NAV flagged red
  • “Designed endpoints” (sinks) and which yield curator vaults / YT are paid from
  • Curator-level exposure (Morpho, Euler), ouroboros detection, bridge mechanism & verification

When to use it

  • Contagion analysis, gauge how far one token's depeg or liquidation reaches
  • Find single points of failure where exposure is over-concentrated
  • Audit a re-deposit chain's depth before sizing a position
  • Assess collateral oracle risk (NAV pricing that can't catch a depeg)
  • Review a curator vault's backing and where its rewards actually originate

Data honesty

ChainSpiral's first principle is simple: we don't guess.

  • Every particle is a real on-chain transfer, nothing is synthesized or fabricated.
  • Counterparties are resolved only via verified registries (CREATE2, MetaRegistry, aToken, Comet, singletons).
  • Transfers that can't be resolved stay panel-only, never placed on an edge.
  • If the feed fails, it's stated explicitly (the live-status chip), not disguised as “no activity”.
  • Nodes without a measurement adapter are shown with a dashed outline as “unmeasured”, not greyed out as if quiet.
All data is informational only and not investment advice. On-chain data may be delayed or reorganized.

FAQ

How real-time is it?
The transfer feed runs about 1 minute behind, re-querying a 30-minute window every 30 seconds.

Which chains are supported?
Ethereum, Base and Arbitrum for live flow; other chains via alerts and gradual expansion. See coverage →

Do I need to connect a wallet?
No. It's read-only monitoring, no wallet connection or signing required.

Where does the data come from?
market & TVL aggregators (TVL, prices), transfer indexers (transfers), lending & vault APIs, on-chain RPC (oracle / aToken / Comet checks) and Postgres snapshots (alert diffs, baseline aggregates). Full list →