Crypto Analytics Engine API

📚 Documentation

• /docs — Interactive Swagger documentation. Test all endpoints directly in the browser.
• /openapi.json — Raw OpenAPI schema (JSON) for integration with external tools.

🔌 Core Data Endpoints (JSON)

All endpoints are served under /api/v1/market_chart.

• Raw market data
  /api/v1/market_chart/?symbol=bitcoin&currency=eur&days=30&provider=coingecko
  Returns the historical price series for a crypto pair and provider.
• Summary statistics
  /api/v1/market_chart/stats?symbol=bitcoin&currency=eur&days=30&provider=coingecko
  Returns count, min, max, mean, median, standard deviation, variance, first/last price and percent change.
• Enriched DataFrame (analytics)
  /api/v1/market_chart/dataframe?symbol=ethereum&currency=usd&days=60&provider=coingecko&window_size=10&volatility_window=20&normalize_base=100&frequency=weekly
  Returns an enriched pandas DataFrame (encoded as JSON) with returns, rolling windows, volatility, normalization and optional resampling (daily, weekly, monthly, yearly).

📈 Enriched Plot Endpoint (PNG)

The backend can also generate PNG plots with multiple analytics overlays (price, rolling mean, volatility, normalization, optional resampling).

• Enriched plot (BTC / EUR — last 60 days)
  /api/v1/market_chart/bitcoin/eur/plot-enriched?days=60&provider=coingecko&window_size=10&volatility_window=5&normalize_base=100
  Returns a binary PNG image suitable for dashboards or external apps.

🧪 Ready-to-use parameter examples

Symbols: bitcoin, ethereum, ripple
Currencies: usd, eur, gbp, chf, jpy
Provider: coingecko
Frequency (resampling): daily, weekly, monthly, yearly

You can plug these values into any of the endpoints above or experiment with them in /docs.

💻 Source Code & Tech Stack

GitHub Repository: github.com/albermar/crypto-analytics-engine

FastAPI Python 3.11 pandas Matplotlib httpx CoinGecko Render