> ## Documentation Index
> Fetch the complete documentation index at: https://docs.walletwall.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Stable Seer
> Stablecoin DEX pair intelligence — peg deviation, liquidity depth, sparklines, risk console, and pool map.
# Stable Seer
Stable Seer is WalletWall's dedicated surface for monitoring stablecoin peg risk, liquidity depth, issuer concentration, and cross-chain flow movement. It provides a focused lens on the stability and utility of the fiat-equivalent ecosystem.
Stable Seer was previously named Market Radar. All identifiers, routes, and API endpoints were renamed as part of Epic #163.
## Product boundary
| Product | Focus | Primary metric |
| ----------------- | ----------------------- | ------------------------------------------------ |
| **Holder Wall** | Holder analytics | Ownership concentration, retention, distribution |
| **Stable Seer** | Stablecoin intelligence | Peg deviation, liquidity depth, issuer/flow risk |
| **Whale Watcher** | Activity intelligence | Large wallet movements, inflow/outflow alerts |
Stable Seer does not provide holder analytics. The `holderAnalyticsSupported: false` flag is present on every API response as a hard invariant.
## Covered stablecoins
Stable Seer prioritizes depth and stability analysis for:
* **Fiat-backed**: USDC, USDT, PYUSD, FDUSD
* **Crypto-backed / over-collateralized**: DAI, LUSD, crvUSD
* **Algorithmic / hybrid**: FRAX, USDE
## Data views
* Real-time peg check: price variance from \$1.00 across major DEX and CEX pairs
* Historical volatility: frequency and depth of de-pegging events over 24h, 7d, and 30d windows
* DEX liquidity depth: aggregated ±% depth for stable-to-stable and stable-to-volatile pairs
* Issuer risk: concentration of supply within specific minting/redemption entities
* Chain distribution: percentage of total supply deployed across Ethereum, Base, Optimism, Arbitrum, and other EVM-compatible chains
* Market cap momentum: 24h/7d change in circulating supply
* Velocity: ratio of volume to market cap — identifies "parked" vs. "active" stablecoin capital
* Inflow/outflow by protocol: stablecoin migration into and out of major DeFi protocols (Aave, Maker, Curve)
* Whale movements: source-backed tracking of large stablecoin transfers between CEXs and unlabeled wallets
### Supply & Flows panel (live)
The **Stablecoin Supply & Flows** panel ships today, backed by the free, keyless
DeFiLlama stablecoins API (the `/api/stablecoin-supply` route, 6-hour durable cache with
telemetry and graceful fallback):
* Top USD-pegged stablecoins ranked by circulating supply
* Per-coin **7-day and 30-day mint/redeem flow** (net supply change)
* Live **peg deviation** from \$1.00
* **Backing mechanism** label (fiat-backed, crypto-backed, algorithmic)
### Homepage Market Context Rail
The WalletWall homepage carries a stablecoin market context rail fed by the same
DeFiLlama source. Its chips include **"The Largest"** (dominance) and **"The
Biggest"** — the stablecoin with the largest 7-day circulating-supply change,
computed from `circulatingPrevWeek` and filtered to assets above \$5M so a tiny
coin's noisy percentage swing cannot win the slot.
## UI concepts
| Concept | Description |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Rein Check** | High-confidence peg verification badge — signals when a stablecoin is trading within strict tolerance (e.g., $0.999–$1.001) |
| **Stable Shopper** | Interface for identifying the deepest liquidity pools for large-size stablecoin swaps |
| **Herd Movement** | Visualization of aggregate stablecoin flows between chains or into yield-bearing protocols |
| **Pasture Map** | Treemap of market cap distribution across issuers and chains |
| **Barn Risk** | Risk score based on collateralization transparency, liquidity depth, and historical peg stability |
## Risk Console
The Risk Console is a summary panel that aggregates peg deviation status, liquidity depth, issuer concentration risk, and the Barn Risk score for a selected stablecoin into a single view.
Risk scores are historical or point-in-time observations derived from scheduled Dune queries and market provider data. They are not investment advice and do not constitute a prediction of future peg stability.
## Sparklines
Price sparklines display peg deviation history over selectable windows (24h, 7d, 30d). They are rendered from CoinGecko and DEX Screener market data, not from Dune scheduled queries.
## Pool map
The pool map visualizes liquidity pool distribution for a selected stablecoin across DEX venues and chains. Pool data is sourced from DEX Screener.
## Filters
Filters allow narrowing by chain, DEX venue, and stablecoin type (fiat-backed, crypto-backed, algorithmic). Filters operate client-side against the current result set.
## Data sources
| Source | Used for | Latency |
| -------------- | ------------------------------------------------------ | ---------------- |
| CoinGecko | Price, volume, market cap | Low |
| DEX Screener | Liquidity depth, pool data | Low |
| Dune Analytics | On-chain supply distribution, historical flow movement | Scheduled/cached |
All Dune Analytics data reflects the state of the last successful query execution and is not live. The UI labels Dune-sourced data as Scheduled/Cached.
## Data flow
```mermaid theme={null}
%%{init: {'theme': 'base', 'themeVariables': {'actorBkg': '#B84923', 'actorBorder': '#6B2412', 'actorTextColor': '#FFF7E8', 'actorLineColor': '#8A5A1F', 'signalColor': '#2B2118', 'signalTextColor': '#2B2118', 'labelBoxBkgColor': '#A7B0B5', 'labelBoxBorderColor': '#59646A', 'labelTextColor': '#172014', 'loopTextColor': '#2B2118', 'noteBkgColor': '#D6A85A', 'noteBorderColor': '#8A5A1F', 'noteTextColor': '#2B2118', 'activationBkgColor': '#FAFAF0', 'activationBorderColor': '#B87333', 'sequenceNumberColor': '#FFF7E8'}}}%%
sequenceDiagram
actor User
participant UI as Stable Seer UI
participant API as /api/stable-seer
participant Live as DEX Screener + CoinGecko
participant Dune as Dune Analytics cache
User->>UI: Select a stablecoin
UI->>API: GET /api/stable-seer?q=...
API->>Live: Fetch price, peg deviation, liquidity depth
Live-->>API: Live market data
API->>Dune: Read cached on-chain supply distribution
Dune-->>API: Scheduled/cached supply snapshot
API-->>UI: Peg, liquidity, and supply-change context
Note over API,Dune: All Dune data is scheduled/cached, never live.
UI-->>User: Stable Seer panel (supply change, not mint/redeem flow)
```
*DEX Screener and CoinGecko supply live price and liquidity data; Dune supplies
scheduled/cached on-chain supply-distribution context. Stable Seer reports supply
change over a window, not a mint/redeem transaction flow — it observes public market
and on-chain data and never initiates or tracks issuer mint/redeem activity directly.*
## API response shape
Stable Seer API endpoints return a normalized structure:
```json theme={null}
{
"asset": "USDC",
"data": {
"price": 1.0002,
"peg_deviation_bps": 2,
"market_cap_usd": 32000000000,
"liquidity_depth_2pct_usd": 450000000,
"volume_24h_usd": 1200000000,
"supply_distribution": {
"ethereum": 0.85,
"base": 0.10,
"arbitrum": 0.05
}
},
"metadata": {
"sources": [
{ "name": "CoinGecko", "type": "market", "latency": "low" },
{ "name": "DEX Screener", "type": "liquidity", "latency": "low" },
{ "name": "Dune Analytics", "type": "on-chain-scheduled", "last_updated": "" }
],
"confidence_score": 0.98
}
}
```
## Stablecoin Vault handoff
Stable Seer's stablecoin exposure signals — peg health, issuer concentration, liquidity depth, and cross-chain flows — are inputs to the **Stablecoin Vault** readiness assessment (`vault.walletwall.org` / `/stablecoin-vault`). When a user has a wallet address in context, Stable Seer data contributes to the readiness engine that determines whether the wallet is a candidate for the testnet vault rehearsal.
The Stable Seer product boundary is intelligence-only: it does not initiate vault enrollment, does not suggest financial actions, and does not provide advice. The Stablecoin Vault is the action-layer destination.
An internal, unwired data foundation for Aave v3 Ethereum stablecoin-reserve
yield evidence (supply APY, reward APY, total APY, and market-level TVL,
sourced from DeFiLlama's yields API) exists as a shadow feature layer
intended to feed future Stable Seer market context. It is not surfaced in
any UI, score, or recommendation today — no yield ranking, no "best rate,"
no projected return.
## Guardrails
* All Dune data is labeled as scheduled and cached — never live.
* Solana holder analytics are not supported. Aggregate market-level data (price/volume) for Solana-based stablecoins may be available via market providers only.
* No deanonymization: attribution is limited to public and source-backed labels.
* Data is for informational purposes only. Not investment advice.
## Related surfaces
Quantum exposure and dormancy facts are stablecoin-scoped (curated `stablecoins_multichain.*` Dune tables) — the same stablecoin domain Stable Seer monitors for peg and liquidity risk.
Stable Seer's peg, issuer-concentration, and liquidity signals are inputs to the Stablecoin Vault readiness assessment — the action-layer destination.