README.md

---
title: CryptoAgentBench API
emoji: 📈
colorFrom: indigo
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---

# CryptoAgentBench API

Benchmarks open-source LLMs as crypto trading agents.

## Endpoints

- `GET /` — health check
- `GET /models` — list available free-tier LLMs
- `GET /benchmarks` — describe A/B/C benchmarks
- `POST /backtest` — launch a backtest run
- `GET /runs/{run_id}` — get run details + equity curve
- `GET /runs/{run_id}/decisions` — get decision log
- `GET /leaderboard` — all completed runs sorted by date

## Environment Variables

Set in HuggingFace Space Secrets:
- `OPENROUTER_API_KEY` — required
- `CRYPTOPANIC_API_KEY` — optional (news)
- `CRYPTOCOMPARE_API_KEY` — optional (news fallback)