# 1. Clone
git clone https://github.com/chuddyrudd/sparky-crypto-prices.git
cd sparky-crypto-prices

# 2. Setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 3. Run
python3 app.py
# Server starts on http://localhost:8000

# 4. Test
curl http://localhost:8000/health

curl "http://localhost:8000/prices?coins=bitcoin,ethereum,solana"

{
  "timestamp": "2026-02-26T11:45:00",
  "prices": {
    "bitcoin": { "usd": 67245.00, "usd_24h_change": 2.5 },
    "ethereum": { "usd": 3521.40, "usd_24h_change": -1.2 },
    "solana": { "usd": 145.20, "usd_24h_change": 5.1 }
  },
  "source": "CoinGecko cached via Sparky",
  "note": "Upgrade to paid v2 coming"
}

curl "http://localhost:8000/fetch?url=example.com"

{
  "timestamp": "2026-02-26T11:45:00",
  "url": "https://example.com",
  "title": "Example Domain",
  "meta_description": "This domain is for use in illustrative examples...",
  "clean_content": "Clean article text without ads or HTML tags...",
  "tables": [],
  "links": ["https://example.com/page1", "https://example.com/page2"],
  "images": ["https://example.com/image.jpg"],
  "source": "Sparky Web Fetch (requests + trafilatura)",
  "note": "Clean, no ads, no HTML garbage. Use ?url=example.com"
}

curl http://localhost:8000/health

{
  "status": "ok",
  "version": "v1-crypto+webfetch",
  "uptime": 1772120121.51
}

curl http://localhost:8000/.well-known/agent.json

{
  "name": "Sparky Tools Oracle",
  "description": "Crypto prices + Web Fetch (clean structured URL to JSON). Free v1.",
  "url": "https://your-tunnel-url/prices or /fetch?url=",
  "capabilities": ["crypto-prices", "web-fetch", "structured-scrape"],
  "protocol": "http"
}

# Get crypto prices
result = web_fetch("http://localhost:8000/prices?coins=bitcoin,ethereum")
# Returns: {"prices": {"bitcoin": {"usd": 67245, ...}}}

# Scrape web content
result = web_fetch("http://localhost:8000/fetch?url=news.ycombinator.com")
# Returns: {"title": "Hacker News", "clean_content": "...", "links": [...]}

# 1. Research workflow
def research_topic(topic):
    # Search for topic
    search_url = f"https://en.wikipedia.org/wiki/{topic}"
    content = web_fetch(f"http://localhost:8000/fetch?url={search_url}")
    return content["clean_content"]

# 2. Crypto tracking workflow
def track_crypto_portfolio(coins):
    prices = web_fetch(f"http://localhost:8000/prices?coins={coins}")
    return prices["prices"]

# 3. Combined workflow
def analyze_crypto_news(coin):
    # Get price
    price_data = web_fetch(f"http://localhost:8000/prices?coins={coin}")
    # Get news context
    news = web_fetch(f"http://localhost:8000/fetch?url=coinmarketcap.com/currencies/{coin}/news")
    return {"price": price_data, "context": news["clean_content"]}

# Track Bitcoin price
curl "localhost:8000/prices?coins=bitcoin"

# Track portfolio
curl "localhost:8000/prices?coins=bitcoin,ethereum,solana,cardano,polkadot"

# Extract article content
curl "localhost:8000/fetch?url=medium.com/article-about-ai"

# Scrape documentation
curl "localhost:8000/fetch?url=docs.python.org/3/tutorial"

# Your OpenClaw agent can now:
# 1. Check crypto prices
# 2. Scrape web content
# 3. Build knowledge bases
# 4. Monitor websites for changes

python3 app.py

cloudflared tunnel --url http://localhost:8000

npm install -g pm2
pm2 start app.py --name sparky-api --interpreter python3
pm2 save
pm2 startup

# Copy service file (create your own)
sudo cp sparky-api.service /etc/systemd/system/
sudo systemctl enable sparky-api
sudo systemctl start sparky-api

┌─────────────┐     HTTP GET     ┌─────────────────┐     HTTPS     ┌──────────────┐
│   Client    │◄────────────────►│  FastAPI Server │◄────────────►│  CoinGecko   │
│  (Any HTTP) │    JSON Response │  (this repo)    │   REST API    │     API      │
└─────────────┘                  └─────────────────┘               └──────────────┘
                                        │
                                        ▼
                              ┌───────────────────┐
                              │   Web Pages       │
                              │   (any URL)       │
                              └───────────────────┘

PORT=8000
TELEGRAM_BOT_TOKEN=your_token_here
TELEGRAM_BOT_CHAT_ID=your_chat_id_here