Skill: finskills/crypto-market-analyst (version 1.0.1)

--- name: Crypto Market Analyst version: 1.0.2 description: "Analyze Bitcoin, Ethereum, and major altcoins using real-time price, on-chain signals, and macro context from the Finskills API." author: finskills metadata: openclaw: requires: env: - FINSKILLS_API_KEY primaryEnv: FINSKILLS_API_KEY homepage: https://github.com/finskills/crypto-market-analyst --- # Crypto Market Analyst Analyze the cryptocurrency market using real-time and historical price data from the Finskills API free-tier crypto endpoints. Covers Bitcoin, Ethereum, and major altcoins with market cap, dominance, volatility, and crypto-specific cycle analysis (halving cycles, fear/greed dynamics, altcoin seasons). Synthesizes a structured market regime classification and actionable positioning guidance. --- ## Setup **API Key required** — [Register at https://finskills.net](https://finskills.net) to get your free key. Header: `X-[REDACTED_SECRET]` > **Get your API key**: Register at **https://finskills.net** — free tier available, Pro plan unlocks real-time quotes, history, and financials. --- ## When to Activate This Skill Activate when the user: - Asks about Bitcoin, Ethereum, or altcoin prices - Wants to understand current crypto market conditions - Asks "is crypto in a bull or bear market?" - Wants a market cap or dominance analysis - Asks about crypto-specific concepts: halvings, altcoin season, Bitcoin dominance - Asks to compare multiple crypto assets - Wants to know the risk/opportunity in the crypto market right now --- ## Data Retrieval — Finskills API Calls ### 1. Market Overview (Top Coins by Market Cap) ``` GET https://finskills.net/v1/free/crypto/markets ``` Extract (for top 20+ coins): - `id`: coin identifier (bitcoin, ethereum, solana, etc.) - `name`, `symbol` - `current_price` - `market_cap` - `market_cap_rank` - `price_change_percentage_24h` - `price_change_percentage_7d` - `total_volume` (24h) - `circulating_supply` - `high_24h`, `low_24h` - `ath` (all-time high), `ath_change_percentage` (% from ATH) ### 2. Single Coin Price + Details For any specific coin the user asks about: ``` GET https://finskills.net/v1/free/crypto/price/{coinId} ``` Examples: `bitcoin`, `ethereum`, `solana`, `cardano`, `avalanche-2`, `chainlink` Extract: current price, market cap, volume, price change (24h, 7d, 30d) ### 3. Historical Price Data (Trend Analysis) For BTC and ETH (primary assets), and any requested altcoin: ``` GET https://finskills.net/v1/free/crypto/history/{coinId} ``` Extract: date series, price series Compute: 7-day/30-day/90-day returns, drawdown from ATH, 30-day rolling volatility --- ## Analysis Workflow ### Step 1 — Market Cap & Dominance Analysis From the markets data, compute: **Total Crypto Market Cap:** ``` Total_MCap = sum(market_cap for all coins in response) ``` **Bitcoin Dominance:** ``` BTC_Dominance = BTC_market_cap / Total_market_cap × 100 ``` **Ethereum Dominance:** ``` ETH_Dominance = ETH_market_cap / Total_market_cap × 100 Altcoin Dominance = 100 - BTC_Dominance - ETH_Dominance ``` **Dominance Signal:** | BTC Dominance | Signal | |--------------|--------| | > 55% | Risk-off; Bitcoin outperforming; early bull or bear market | | 45–55% | Balanced; mainstream phase; ETH/large caps performing | | < 45% | Altcoin season; speculation elevated; late-cycle risk | ### Step 2 — Bitcoin Cycle Analysis **Key Bitcoin Halving Cycle Facts:** - Halving events approximately every 4 years (~210,000 blocks) - Last halving: April 2024 - Historical pattern: Strongest appreciation typically 12–18 months post-halving - Cycle phases: Accumulation → Early Bull → Full Bull → Peak → Distribution → Bear → Capitulation → Recovery **Current Cycle Position:** Based on time since last halving (April 19, 2024), estimate cycle phase: - 0–6 months post-halving: Accumulation / Early Bull - 6–18 months post-halving: Bull market expansion - 18–30 months post-halving: Late bull, increasing volatility - 30–48 months post-halving: Distribution / Bear market **ATH Distance:** ``` BTC_ATH_Distance = (BTC_current_price / BTC_ath) - 1 (as %) ``` - Within 20% of ATH: Price discovery zone / near peak - 20–60% below ATH: Bull market territory - > 60% below ATH: Capitulation / deep bear ### Step 3 — Volatility & Risk Assessment **30-Day Rolling Volatility (Annualized):** From historical price data: ``` daily_returns = price.pct_change() vol_30d_annualized = daily_returns.rolling(30).std() × sqrt(365) × 100 ``` Crypto Volatility Regimes: - < 40% annualized vol: Low volatility — consolidation or gradual bull - 40–80%: Normal crypto volatility - > 80%: High volatility — extreme moves likely in both directions - > 120%: Crisis / capitulation volatility **Drawdown from ATH:** ``` Max drawdown from ATH = (current_price - ath) / ath × 100 ``` **Sharp Decline Detector (last 7 days):** - If 7-day return < -20%: Cascade selloff / forced liquidation — potential bounce setup - If 7-day return > +30%: Parabolic move — profit-taking warning ### Step 4 — Altcoin Season Index Estimate altcoin season based on dominance ratios and altcoin vs. BTC performance: **Altcoin Season Signal:** - If > 75% of top 50 altcoins outperformed BTC in last 30 days: **Altcoin Season** 🔥 - If 25–75% outperformed: **Ambiguous / Mixed** market - If < 25% outperformed BTC: **Bitcoin Season** — capital concentrated in BTC From the markets data, compute how many of the top 20 coins beat BTC's 7-day return: ``` beating_btc = count(coin for coin in top_20 if coin.7d_return > BTC.7d_return) ratio = beating_btc / 20 ``` - > 0.75: Altcoin season - 0.25–0.75: Mixed - < 0.25: Bitcoin season ### Step 5 — Layer-1 Competition Analysis For major L1 blockchains (ETH, SOL, ADA, AVAX), compute relative performance vs. BTC: ``` Relative_Return = coin_7d_return - BTC_7d_return ``` Identify which L1s are gaining / losing market share. ### Step 6 — Macro Correlation Assessment Crypto increasingly correlates with risk assets (Nasdaq) during certain regimes: - If broad equity market is in risk-off (use `/v1/market/summary` if available): Crypto headwind - If monetary policy is tightening (high real rates): Suppresses speculative assets including crypto - BTC as "digital gold" narrative: Check if gold is also rallying (use `/v1/free/commodity/price/gold`) Note the correlation context without making definitive claims. ### Step 7 — Sentiment Proxy Use market data as a sentiment proxy (actual Fear & Greed Index data unavailable): **Sentiment Estimation from Data:** - **Extreme Greed**: BTC within 10% of ATH + altcoins > BTC + high volume - **Greed**: BTC 10–25% from ATH + broad crypto market rising - **Neutral**: Mixed performance + normal volume - **Fear**: BTC 25–50% from ATH + altcoins underperforming + declining volume - **Extreme Fear**: BTC > 50% from ATH + most altcoins at deep losses + low volume / capitulation --- ## Output Format ``` ╔══════════════════════════════════════════════════════════════╗ ║ CRYPTO MARKET REPORT — {DATE} ║ ╚══════════════════════════════════════════════════════════════╝ 📊 MARKET OVERVIEW Total Crypto Market Cap: ${X}T / ${X}B 24H Volume: ${X}B BTC Dominance: {X.X}% [{Signal: Risk-Off / Balanced / Altcoin Season}] ETH Dominance: {X.X}% Altcoin Dom.: {X.X}% Season: → {BITCOIN SEASON / MIXED / ALTCOIN SEASON 🔥} ₿ BITCOIN Price: ${price} 24H: {+/-X}% 7D: {+/-X}% 30D: {+/-X}% Market Cap: ${X}B ATH: ${ath} (${ath_distance}% from ATH) 30D Volatility: {X}% annualized Cycle Status: {N} months since April 2024 halving Phase: {ACCUMULATION / EARLY BULL / BULL EXPANSION / LATE BULL / BEAR} BTC Regime: → {ACCUMULATION / BULL MARKET / RISK ZONE / BEAR MARKET} Ξ ETHEREUM Price: ${price} 24H: {+/-X}% 7D: {+/-X}% Market Cap: ${X}B ETH/BTC Ratio: {ratio} [{ETH strong vs BTC / ETH lagging BTC}] ATH Distance: {-X}% 🌐 TOP ALTCOINS (vs. BTC 7D: {BTC_7d}%) Rank Name Symbol Price 7D vs. BTC MCap ──── ────────── ────── ────────── ─────── ─────── ───────── 3 Solana SOL ${price} {+/-X}% {+/-X}% ${B}B 4 XRP XRP ${price} {+/-X}% {+/-X}% ${B}B 5 BNB BNB ${price} {+/-X}% {+/-X}% ${B}B 6 Avalanche AVAX ${price} {+/-X}% {+/-X}% ${B}B 7 Cardano ADA ${price} {+/-X}% {+/-X}% ${B}B ... Top Performers (7D, vs BTC): {list top 3 outperformers} Laggards (7D, vs BTC): {list top 3 underperformers} Altcoins beating BTC (7D): {N}/20 = {%} → {Altcoin Season / Mixed / BTC Season} 📉 RISK ASSESSMENT Market-Wide Drawdown from ATH: {X}% Estimated Sentiment: {EXTREME GREED / GREED / NEUTRAL / FEAR / EXTREME FEAR} Key Risk: {Specific concern if elevated} 💡 POSITIONING SIGNALS BTC View: {BULLISH — accumulate / NEUTRAL — hold / BEARISH — reduce} ETH vs. BTC: {ETH gaining / losing relative strength → flip / hold allocation} Altcoin Exposure: {Max exposure now / Reduce to BTC+ETH only} Rationale: {2-sentence synthesis of the above data points} 📌 MACRO CONTEXT {Note any relevant macro factors: Fed policy, equity correlation, dollar strength, gold comparison} 🔍 KEY LEVEL TO WATCH {The most important price level or ratio to monitor for a regime shift signal} ``` --- ## Limitations - Crypto markets trade 24/7; data may be minutes old but not real-time tick data. - Regulatory risks (SEC actions, country bans) are not captured in price data alone. - Halving cycle analysis is based on historical patterns — the 4th+ cycles may behave differently. - DeFi-specific metrics (TVL, protocol revenue, DEX volume) are outside this skill's scope. - Crypto is a highly speculative asset class; treat all analysis as research, not investment advice.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)