# SparkForge API — llms.txt
# 27 utility APIs for AI agents. Pay per call via x402 (USDC on Base/Polygon/Solana) or use free via MCP.
# Base URL: https://sparkforge.sh
# Full docs: https://sparkforge.sh/docs
# Full machine-readable docs: https://sparkforge.sh/llms-full.txt
# MCP server: https://sparkforge.sh/api/mcp
# Agent card (ERC-8004): https://sparkforge.sh/.well-known/agent-card.json
# Agent #21187 on Virtuals ACP marketplace

## Quick Start
# All endpoints are POST. No API keys needed. Payment via x402 (automatic with @x402/fetch).
# Demo mode: add ?demo=true to any GET request for a free sample response.

## 🎨 Creative Endpoints

POST /api/generate — AI image generation via Flux (Schnell/Dev/Pro). Body: {prompt, model?, width?, height?}. Price: $0.02–$0.05
POST /api/image-resize — Resize/convert/optimize images via Sharp. Body: {url, width?, height?, format?}. Price: $0.002
POST /api/meme — Meme generation with text overlay. Body: {topText?, bottomText?, template?, imageUrl?}. Price: $0.03
POST /api/video — AI video generation via fal.ai. Body: {prompt, duration?}. Price: $0.10
POST /api/tts — Text-to-speech via ElevenLabs. Body: {text, voice?}. Price: $0.05

## 📊 Trading & Crypto Endpoints

POST /api/btc-signal — 8-indicator BTC technical analysis (taker flow, OI, funding rate, CVD, RSI, EMA). Body: {timeframe?}. Price: $0.01
POST /api/crypto-price — Real-time crypto prices via CoinGecko. Body: {symbol}. Price: $0.001
POST /api/token-research — AI token research report with fundamentals, sentiment, risk. Body: {token, chain?}. Price: $0.10
POST /api/wallet-analysis — Wallet analysis: holdings, PnL, risk profile. Body: {address, chain?}. Price: $0.05

## 📄 Document Endpoints

POST /api/pdf-to-markdown — Convert PDF URL to Markdown. Body: {url}. Price: $0.005
POST /api/markdown — Convert HTML page URL to clean Markdown. Body: {url}. Price: $0.001
POST /api/summarize — Text summarization. Body: {text, maxLength?}. Price: $0.005

## 🌐 Web Endpoints

POST /api/screenshot — Capture webpage as PNG. Body: {url, fullPage?}. Price: $0.005
POST /api/scrape — Full web scraping with JS execution. Body: {url, selector?, format?}. Price: $0.01
POST /api/url-metadata — Extract OG tags, title, favicon, canonical. Body: {url}. Price: $0.001

## 🛠️ Developer Endpoints

POST /api/qrcode — Generate QR codes. Body: {data}. Price: $0.001
POST /api/json-validate — JSON syntax + schema validation. Body: {json, schema?}. Price: $0.001
POST /api/diff — Unified diff between two texts. Body: {text1, text2}. Price: $0.001
POST /api/detect-language — Language detection (50+ languages). Body: {text}. Price: $0.001
POST /api/code-review — AI code review with bug/security/perf analysis. Body: {code, language?, focus?}. Price: $0.01

## Payment
# x402 protocol — automatic USDC micropayments
# Supported chains: Base (eip155:8453), Polygon (eip155:137), Solana (solana:mainnet)
# npm: @x402/fetch — wraps fetch() to handle 402 Payment Required responses automatically

## Free Access via MCP
# Add to MCP config: {"mcpServers": {"sparkforge": {"url": "https://sparkforge.sh/api/mcp"}}}
# All 20 tools available free via MCP for Claude Desktop, Cursor, Windsurf, and other MCP clients