Reading the city
Every visual has a declared job.
The city is expressive, but its mappings are deliberately constrained. This page explains what each signal means—and what it does not mean.
Projects and market groups
Live project membership comes from CoinGecko's paginated market and category feeds. Stablecoins and wrapped tokens are excluded using provider categories. Category membership is never inferred from a name or ticker.
Ranked views cover Top 10–250 eligible projects. The Overall market also offers Total, which appends repository-curated CoinGecko IDs and orders them by provider rank. These additions never imply category membership.
Project visual mappings
- Market cap
- Fixed logarithmic scale for territory radius, landmark height, and skyline density.
- 24h volume
- Number of cars owned by and circulating around that project's district.
- Activity
- Car speed, labeled by metric kind, unit, source, capture time, and confidence.
- Turnover
- Drone activity, calculated from 24h volume divided by market cap.
- Price change
- Red, neutral, or green district heat for the selected 1h, 24h, or 7d timeframe.
- Large moves
- Construction and coin activity above +5%; warning, fire, and smoke below −5%, with hysteresis.
CoinGecko project activity currently uses a clearly labeled trading-volume proxy measured as USD volume per minute. It is not described as on-chain transactions.
Exchange mode
Exchange mode shows CoinGecko's Trust Top 50 active spot exchanges. BTC-denominated 24-hour volume is converted using CoinGecko's BTC/USD exchange rate. Users may order the city by current volume or CoinGecko rank; tower and territory scale continue to represent volume in both orders.
CoinGecko Trust Score and rank are comparative provider signals—not safety guarantees, endorsements, solvency checks, or custody assessments.
Until shared exchange history exists, exchange mode has no timeframe heat, movers, or gain/loss construction and damage effects.
Dashboard scopes and calculations
Dashboard preferences are independent from the City and Gallery. Its Top 100 and heatmap use the first 100 eligible provider-ranked projects in the selected Dashboard category. Display sorting and filters are applied only after that ranked set is fixed. Watchlist, Comparison, and search use the eligible Overall Top 250 plus configured Overall additions; they do not imply membership in the active category.
- Global Market
- CoinGecko's provider-wide current totals, 24-hour market-cap change, volume, and BTC/ETH dominance. These are not filtered to the Dashboard category.
- Heatmap
- Tile area represents current market cap; color and signed text represent active-timeframe change. Missing change is neutral.
- Sectors
- Exact supported CoinGecko category IDs, fixed to the provider's 24-hour category change regardless of the Dashboard timeframe.
- Comparison
- A normalized seven-day price path beginning at 0% for each valid series. Numeric 1h, 24h, and 7d fields remain exact snapshot values.
- Bitcoin sentiment
- Alternative.me's daily Fear & Greed Index. CryptoCity labels 0–20 Extreme Fear, 21–40 Fear, 41–60 Neutral, 61–80 Greed, and 81–100 Extreme Greed, visualized respectively as a severe cold storm with localized lightning, dark cloud and rain, blue-gray overcast clearing, natural blue-sky daylight, and a pristine summer sky with restrained sun. The current score appears once inside a compact CSS/SVG atmospheric lens; its movement and interpretation are derived from the current and previous daily readings, while Recent History contains Yesterday, Last week, and Last month. Full-panel original plates remain visible beneath localized readability scrims. Score, history, scale, attribution, and the accessible summary remain semantic page content. One isolated decorative PixiJS canvas may animate precipitation, moving mist and cloud depth, localized light, sun, and atmospheric motes; it never changes the data. The atmosphere does not follow the Dashboard timeframe and is not a forecast or a measure of every crypto asset. It pauses off-screen or in a hidden tab, while reduced motion, WebGL/context loss, or asset failure uses the complete still plate.
Freshness, simulation, and news
- Market refresh
- Project data is shared across City, Gallery, and Dashboard on a ten-minute cadence; exchange overviews refresh every thirty minutes. Durable server and 24-hour device fallbacks are visibly marked stale.
- Dashboard totals and sectors
- Global totals refresh every ten minutes and 24-hour sectors refresh hourly, with a 24-hour device fallback.
- Bitcoin sentiment
- Refreshed hourly with a 72-hour device fallback and always attributed to Alternative.me.
- Project details
- Fetched only after explicit selection and cached for 24 hours.
- Simulation
- Deterministic City/Gallery fixtures are emitted through the normal market contract and always labeled. Development builds also provide a separate non-live Market Weather animation preview; its synthetic score changes only the decorative Dashboard module and selecting Live restores the provider reading.
- News
- One server-published seven-day snapshot shared by all visitors from fixed RSS/Atom sources.
Roads between adjacent districts are neutral infrastructure. They do not encode trading pairs, ecosystems, correlations, bridges, capital movement, or on-chain flows.
Virtual challenge execution
Hold challenges convert every submitted 100.00% allocation into virtual quantities from one shared CoinGecko opening snapshot, then mark those quantities to the same shared reference prices. Trading challenges begin the same way with zero cash. Competitors must sell before buying, and accepted virtual spot orders execute together at the next published five-minute UTC window.
- Reference price
- A shared CoinGecko aggregated USD price for every project and execution window—not a bid, ask, or fill available on any exchange.
- Operations
- Each filled buy or sell counts once. Pending orders reserve daily and weekly UTC quota; cancellation, rejection, or expiry releases it.
- Trading model
- Exact-amount buys and quantity sells, with zero simulated fees and slippage. No swaps, partial fills, leverage, shorting, borrowing, yield, or limit orders.
- Disclosure
- Filled trades, current holdings, and published standings are public. Queued, cancelled, rejected, and expired orders remain private to their owner and administrators.
Quotes must be positive, carry a real provider timestamp, and be no more than 120 seconds old. Missing or stale prices never create a historical backfill. CryptoCity preserves the last complete valuation and may pause a window or place a final result in attention until a valid current snapshot is available. Value charts sample every ten minutes; immutable filled trades retain the full execution record.
Known limitations
Provider coverage, classification, ranking, exchange-reported volume, network conditions, and browser performance can affect what appears. Visual contrast curves improve readability, so object counts and physical dimensions are not literal financial quantities.
CryptoCity displays capture times and stale states where available and never silently replaces failed live data with simulation.