--- name: coinmarketcap-crypto-market-snapshot description: Produce a dated, sourced briefing of the whole crypto market right now (global regime, leading assets, derivatives positioning and macro calendar) so the reader understands conditions before deciding anything. Use when the user asks how the market is doing, what the market mood is, whether it is risk-on or risk-off, what the crypto market looks like today, or wants a market overview before a decision. --- # Crypto market snapshot A snapshot answers one question: **what is the state of the market as a whole, as of this timestamp, and how confident are we in each part?** It is a broad read, not an opinion about any single coin. Keep the reader oriented: regime first, then leaders, then positioning, then what is scheduled ahead. Every figure carries its time. ## 1. Fix the timestamp and the scope Before calling anything, state the time you are reporting as of (use the time of the data you receive, and say so). Market data moves; a snapshot without a time is not a snapshot. Ask the user only if they need something specific (a region, a horizon, a particular set of coins); otherwise produce the standard whole-market read. ## 2. Establish the global regime Call `get_global_metrics_latest` first. It gives the backbone: total market capitalisation, 24h volume, dominance of BTC and ETH, and the sentiment gauges the docs list (Fear & Greed, Altcoin Season). Read them as a set: - **Dominance rising while total cap is flat or falling:** capital is consolidating into the largest assets, a defensive posture. Altcoins usually lag. - **Dominance falling with volume rising:** risk appetite is spreading down the market. Check whether it is broad or concentrated in a handful of names. - **Fear & Greed at an extreme** (very low or very high) is a sentiment reading, not a timing signal. Report it as a reading, with no forecast attached. - **Volume with no price move** often means indecision. Say so rather than inventing a direction. If a gauge is missing or returns no value, say "not returned" rather than estimating it. ## 3. Check the market-wide technical state Call `get_crypto_marketcap_technical_analysis` to see whether the total market capitalisation itself is above or below its moving averages and what momentum indicators show. This is the market-level counterpart of single-asset analysis. Describe the direction and whether indicators agree with each other. A single bullish or bearish reading is a data point; several agreeing is a stronger one. Do not describe it as a prediction. ## 4. Identify the leaders and laggards Call `get_crypto_quotes_latest` for the largest assets so the snapshot names real price, market cap, volume and percentage-change figures. Note the spread: if the top few are up strongly and the rest are flat, the picture is narrow, and that matters more than any single figure. Use `search_cryptos` only to resolve a name or symbol the user gives you, not to build a list. ## 5. Read the positioning and derivatives layer Call `get_global_crypto_derivatives_metrics` for leverage, open interest, funding and liquidation context. Interpret with restraint: - **High open interest with rising prices:** positions are building on the move. Note the risk that a reversal triggers forced liquidations. - **Heavy liquidations after a drop:** leverage is being flushed. This often marks stress, not a settled bottom. - **Positive funding** means longs are paying shorts (crowded long); **negative** means the opposite. Report the sign and what it usually indicates, and do not treat it as a trade signal. ## 6. Put the calendar in front of the reader Call `get_upcoming_macro_events` to list scheduled economic events in the window the user cares about (default: the next one to two weeks). Scheduled events are the most predictable source of volatility, so include them even when the rest of the picture is quiet. Give dates and event names exactly as returned. ## 7. Add the narrative and news context only as colour Call `trending_crypto_narratives` to name the sectors gaining attention and `get_crypto_latest_news` only if the user wants headlines or a specific story explains a move. Keep this section short, and label it as context for the numbers above, not as the cause of them. Correlation in a narrative is not proof of cause. ## 8. Write it as one dated read Lead with the regime in a single sentence, then the supporting facts in order. Mark what is data, what is a reading of the data, and what is unknown. ## Common patterns and traps - **Confusing sentiment gauges with signals.** A fear reading describes how people feel. It does not say what happens next. Never phrase it as a forecast. - **Mistaking a rally in a few large assets for a market-wide rally.** Check breadth: how many leaders are up versus how many are not. - **Reporting stale figures as current.** Always state the as-of time, and say if values look out of date relative to the request. - **Treating the top few assets as "the market".** Dominance and total cap can rise while most individual coins fall. Say which one you are describing. - **Reading derivatives data as direction.** Open interest and funding describe positioning and crowding. They do not tell you which way price will go. - **Filling gaps with plausible numbers.** If a metric is not returned, the snapshot says so. An honest gap is worth more than a confident guess. - **Overstating causality from news.** A headline that appeared the same day as a move is context, not the reason. - **Ignoring the calendar.** A quiet market before a major scheduled release is not the same as a quiet market with nothing ahead. ## Output ``` Market snapshot, as of