overview
FastAPI wrapper around the public Codeforces API. Live at codeforces-stats.tashif.codes. Source is tashifkhan/CodeForces-API.
Path param is userid (the handle). Envelope platform is "codeforces". Category in CodeTrace is competitive.
Docs map#
- Overview
- Dashboard
- Canonical endpoints
- Envelope and schemas
- Platform notes
- Architecture
- Official API
- Request path
What it returns#
Rating, max rating, rank titles, contest history, solved count, heatmap from submissions, upcoming contests, and multi-handle helpers.
This is the one stats API that still has first-class non-user routes: upcoming contests, common contests, and /multi/{handles}.
Live access#
- Site: codeforces-stats.tashif.codes
- Playground: playground
- OpenAPI: docs
- Sample JSON: tourist/profile
- Repo: tashifkhan/CodeForces-API
Run it locally#
cd CodeForces
uv sync
uv run python -m uvicorn app:app --reload --port 8003
python app.py binds 8000 in production mode and 58353 in development. Use 8003.