---

name: crypto-market-intel description: Crypto Market Intelligence - Free market data pipeline for any OpenClaw agent. Zero API keys needed. Fetch real-time crypto prices, market metrics, Fear & Greed index, DeFi TVL, stock indices, and macro indicators. Use when you need crypto prices, market data, market analysis, fear and greed, DeFi TVL, stock prices, macro data, market intelligence, or trading signals.

Crypto Market Intelligence

Real-time market data pipeline for crypto, stocks, and macro indicators. Zero API keys required. All data fetched from free public APIs.

When to Use

Trigger this skill when you need:

• Current cryptocurrency prices and market caps
• Bitcoin/Ethereum dominance
• Fear & Greed Index
• Trending coins
• DeFi Total Value Locked (TVL)
• Stock market indices (S&P 500, Nasdaq, Dow, VIX)
• AI stock prices (NVDA, AMD, MSFT, etc.)
• Macro indicators (DXY dollar index, 10Y Treasury yield)
• Pre-fetched data for trading analysis
• Market intelligence for portfolio decisions

Quick Start

Fetch all market data:

cd ~/.openclaw/skills/crypto-market-intel/scripts
python3 market-data-fetcher.py all --output ~/market-data

Analyze market conditions:

./analyze-market.sh

Core Features

✅ 6 Free APIs, Zero Keys

• CoinGecko (coins, global metrics, trending)
• Alternative.me (Fear & Greed Index)
• DeFi Llama (DeFi TVL)
• Yahoo Finance (stocks, indices, bonds)

✅ Crypto Coverage

• Top 30 coins by market cap
• Global market metrics (total mcap, volume, dominance)
• Fear & Greed Index (current + 7-day history)
• Trending coins
• DeFi Total Value Locked

✅ Stocks & Macro

• Major indices (S&P 500, Nasdaq, Dow, VIX)
• AI stocks (NVDA, AMD, AVGO, MRVL, TSM, ASML, ARM, MSFT, AMZN, GOOG, META, ORCL)
• AI energy (VST, CEG, OKLO, SMR, TLN)
• AI infrastructure (VRT, ANET, CRDO)
• Dollar Index (DXY)
• 10-Year Treasury Yield

✅ Agent-Ready Output

• JSON format for easy parsing
• Structured data with timestamps
• Works as cron job or on-demand
• No hallucinated prices — real market data

Usage

Fetch Crypto Data Only

python3 scripts/market-data-fetcher.py crypto --output ./data

Output: data/crypto-latest.json

Fetch Stocks/Macro Only

python3 scripts/market-data-fetcher.py stocks --output ./data

Output: data/stocks-latest.json

Fetch Everything

python3 scripts/market-data-fetcher.py all --output ./data

Automated Analysis

Run the analyzer wrapper to fetch data and generate a market summary prompt:

./scripts/analyze-market.sh ~/market-data

This fetches fresh data and outputs a structured prompt for the agent to analyze:

• Market sentiment (Fear & Greed)
• Top movers (biggest gains/losses)
• Macro environment (DXY, yields, VIX)
• Notable signals

Cron Integration

Schedule hourly market data fetches:

crontab -e

# Fetch market data every hour
0 * * * * cd ~/.openclaw/skills/crypto-market-intel/scripts && python3 market-data-fetcher.py all --output ~/market-data

The agent can then read pre-fetched data for instant analysis without waiting for API calls.

Data Schema

Crypto Output (crypto-latest.json)

{
  "fetched_at": "2026-03-13T15:45:00Z",
  "source": "coingecko+alternative.me",
  "top_coins": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 68500.0,
      "market_cap": 1340000000000,
      "volume_24h": 28000000000,
      "change_24h_pct": 2.5,
      "change_7d_pct": -1.2,
      "change_1h_pct": 0.3,
      "ath": 69000.0,
      "ath_change_pct": -0.7,
      "rank": 1
    }
  ],
  "global": {
    "total_market_cap_usd": 2400000000000,
    "total_volume_24h_usd": 85000000000,
    "btc_dominance": 55.8,
    "eth_dominance": 17.2,
    "active_cryptocurrencies": 13245,
    "market_cap_change_24h_pct": 1.8
  },
  "fear_greed": [
    {
      "value": 62,
      "label": "Greed",
      "date": "1710346800"
    }
  ],
  "trending": [
    {
      "name": "Solana",
      "symbol": "SOL",
      "rank": 5,
      "score": 0
    }
  ],
  "defi_tvl": {
    "total_tvl": 95800000000,
    "date": 1710288000,
    "change_1d": 2.1
  }
}

Stocks Output (stocks-latest.json)

{
  "fetched_at": "2026-03-13T15:45:00Z",
  "stocks": {
    "indices": [
      {
        "symbol": "^GSPC",
        "price": 5200.5,
        "prev_close": 5180.0,
        "change_pct": 0.4
      }
    ],
    "ai_chips": [
      {
        "symbol": "NVDA",
        "price": 890.25,
        "prev_close": 885.0,
        "change_pct": 0.59
      }
    ]
  },
  "dxy": {
    "price": 103.45,
    "prev_close": 103.2
  },
  "treasury_10y": {
    "yield": 4.25,
    "prev_close": 4.22
  }
}

Rate Limits & Fair Use

API	Rate Limit	Notes
CoinGecko	10-50 calls/min	Free tier, no key required
Alternative.me	Unlimited	Public endpoint
DeFi Llama	Unlimited	Public endpoint
Yahoo Finance	~2000 calls/hour	Unofficial API, use responsibly

Recommendation: Run fetcher hourly, not more frequently. APIs are free but fair use matters.

Troubleshooting

Problem: Fetch fails with timeout

Solution: Check network connection, try again in a few minutes. Some APIs have temporary outages.

---

Problem: Yahoo Finance returns no data for a stock

Solution: Symbol may be delisted or unavailable. Check symbol accuracy (use ^ prefix for indices, e.g., ^GSPC).

---

Problem: DeFi TVL is null

Solution: DeFi Llama API may be updating. Historical data endpoint occasionally has lag. Try again later.

---

Problem: Fear & Greed returns empty

Solution: Alternative.me may be down. Check https://alternative.me/crypto/fear-and-greed-index/ directly.

Architecture Notes

• No authentication — all APIs are public, no keys to manage
• HTTP requests only — uses Python's built-in urllib (no external deps)
• Error tolerant — if one API fails, others still succeed
• Portable — works on any system with Python 3.7+
• Configurable output — use --output flag to set data directory

Integration Examples

Discord Bot Alert

#!/bin/bash
python3 scripts/market-data-fetcher.py crypto --output /tmp
FEAR=$(jq '.fear_greed[0].value' /tmp/crypto-latest.json)
if [ "$FEAR" -lt 25 ]; then
  echo "🚨 Extreme Fear detected: $FEAR — potential buy opportunity"
fi

Trading Bot Pre-Analysis

import json

# Load pre-fetched data
with open("~/market-data/crypto-latest.json") as f:
    data = json.load(f)

# Extract top movers
top_coins = data["top_coins"]
gainers = sorted(top_coins, key=lambda x: x["change_24h_pct"], reverse=True)[:5]

print("Top 5 Gainers (24h):")
for coin in gainers:
    print(f"{coin['symbol']}: +{coin['change_24h_pct']:.2f}%")

References

See references/api-sources.md for detailed API documentation, endpoints, response schemas, and rate limit specifics.

---

Last Updated: 2026-03-13