# Chessvia Analysis API

> Best-in-class chess analysis API for developers. Position evaluation, game review, and natural language coaching explanations for chess applications. Detects 70+ tactical patterns and generates move-by-move narratives via simple REST endpoints.

## API Endpoints

- [Position Analysis](https://api.chessvia.ai/docs#/default/analyze_position_analyze_position_post): Evaluate any chess position with best move, evaluation score, tactical pattern detection, and natural language coaching
- [Game Analysis](https://api.chessvia.ai/docs#/default/analyze_game_analyze_game_post): Full game review with move-by-move breakdown, key moment identification, and narrative summary
- Bughouse & Crazyhouse Analysis: The world's first variant coaching — drop quality ratings, fork detection, partner board correlation, time pressure analysis, and session-level coaching across multiple games

## Documentation

- [Interactive API Reference](https://api.chessvia.ai/docs): Swagger UI — try endpoints in the browser
- [Developer Portal](https://api.chessvia.ai/portal/login): API key management, credit balance, and live analysis playground

## Use Cases

- Smart chess boards (DGT, ChessUp, Chessnut, Millennium) — real-time position coaching during play
- Chess apps and platforms — game review, move explanations, and accuracy scoring
- EdTech and chess academies — student game analysis with coaching narratives
- Tournament platforms — live evaluation broadcasts and post-game annotation
- Developer tools — chess analysis as a composable building block

## Key Capabilities

- 70+ tactical and positional patterns detected deterministically (not LLM-hallucinated)
- Natural language coaching explanations at multiple skill levels
- Game narratives: opening identification, key moments, phase-by-phase breakdown
- Sub-5-second position analysis, full game analysis in 15-60 seconds
- Tiered API access with credit-based usage tracking

## About

- [Chessvia](https://www.chessvia.ai): Company homepage
- [Privacy Policy](https://api.chessvia.ai/privacy/extension): Data handling and privacy practices
- Contact: rohan@chessvia.ai