Market Evaluator Engine

A FastAPI-based technical analysis API for cryptocurrency market data. Provides real-time calculation of technical indicators (RSI, MACD, Moving Averages, Bollinger Bands, etc.) with automatic support and resistance level detection.

Features

• Technical Indicators: RSI, MACD, Moving Averages, Bollinger Bands, ATR, Stochastic Oscillator
• Support & Resistance Detection: Automatic identification with confidence scoring
• Customizable Parameters: Configure indicator periods and settings per request
• Market Data Integration: Real-time data from Coinbase Pro
• Caching: Efficient Firestore-based caching for improved performance

Quick Start

# Install dependencies
pip install -r requirements.txt

# Start development server
make run

API Examples

Get Market History with Indicators

curl -g 'http://localhost:8000/history?symbol=BTC-USD&granularity=ONE_HOUR&start_time=2025-01-21T00:00:00Z&end_time=2025-01-21T23:00:00Z&evaluators=[{"id":"rsi"},{"id":"moving-averages"}]'

Detect Support & Resistance Levels

curl 'http://localhost:8000/levels?symbol=BTC-USD&granularity=ONE_HOUR'

List Available Indicators

curl 'http://localhost:8000/evaluators'

Available Technical Indicators

Implemented

• RSI (Relative Strength Index) - rsi
• MACD (Moving Average Convergence Divergence) - macd
• Moving Averages (SMA) - moving-averages
• Bollinger Bands - bollinger-bands
• ATR (Average True Range) - atr
• Stochastic Oscillator - stochastic

Planned

• ADX, Parabolic SAR, Volume Profile, OBV, CCI, Williams %R, Keltner Channels, Fibonacci Retracement, Ichimoku Cloud

See Indicator Roadmap for details.

Documentation

• API Reference - Complete endpoint documentation and parameters
• Indicator Roadmap - Current and planned technical indicators
• Development Guide - Architecture and development workflow

Deployment

# Deploy to Google Cloud Run
make deploy

Tech Stack

• Framework: FastAPI
• Data Storage: Google Cloud Firestore
• Market Data: Coinbase Pro API
• Deployment: Google Cloud Run
• Language: Python 3.11+

Architecture

Clean architecture with separation of concerns:

• API Layer (FastAPI)
• Business Logic (Evaluator Engine)
• Domain Models
• Data Layer (Repository Pattern)
• External Services (Coinbase Integration)

See CLAUDE.md for detailed architecture documentation.

Related Projects

This library is part of the Spot Canvas "ecosystem":

• sc-app – Spot Canvas website and charts application with AI Assistend technical analysis
• rc-charts – The charting library Spot Canvas uses
• spot-server – Price data ingestion

License

MIT