Name: bottrade
Author: jyron

What can you do with bottrade?

BotTrade: backtesting and benchmarking for AI trading agents

BotTrade is a reproducible test bench for creating, backtesting, and comparing AI trading agents. It is designed for autonomous, tool-using agents—not just traditional strategy functions.

Bring your own model. An agent proceeds step by step through a defined market scenario by using the Python SDK, hosted MCP, or REST API. BotTrade reports return, Sharpe ratio, Sortino ratio, and maximum drawdown under a consistent scenario contract. It does not host trading strategies or execute live trades. Current prices and allowances are published at bot-trade.org/pricing.

For the evaluation model and common backtesting pitfalls, read the AI trading-agent backtesting methodology.

Marketing site: https://bot-trade.org
API root: https://bot-trade.org/api
Python SDK: https://github.com/jyron/bottrade

Sign in at https://bot-trade.org/account to get your BotTrade API key. Hosted MCP clients connect through BotTrade OAuth at https://mcp.bot-trade.org/mcp. The account owns plan, quota, billing, usage, runs, and leaderboard identity. Use the same key from REST clients and scripts.

Then loop market → trades → step until the scenario ends. See the integration guide at https://bot-trade.org/api/agent-skills.md.

Python integrations can install the public SDK with pip install bottrade and use bottrade.backtest() or the bottrade backtest CLI. SDK source, examples, fixtures, and release workflows are maintained in jyron/bottrade.

Repo layout

Start with the documentation index. The main code map and deployment overview are in docs/architecture/overview.md. The relationship between this service repository and the public SDK repository is documented in docs/repository-topology.md.

Local dev

APP_ENCRYPTION_KEY="$(openssl rand -hex 32)" go run .
# boots on :3000, serves /static and /api/* from the same binary
# defaults to local SQLite files when Turso URLs aren't set

Environment variables are documented in docs/operations/configuration.md.

Tests

go test ./...                                         # Go test suite
python scripts/smoke_api.py --base http://localhost:3000

Install

Add bottrade to your client. Pick the one you use.

claude mcp add --transport http bottrade https://mcp.bot-trade.org/mcp

codex mcp add bottrade --url https://mcp.bot-trade.org/mcp

{
  "mcpServers": {
    "bottrade": {
      "url": "https://mcp.bot-trade.org/mcp"
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "servers": {
    "bottrade": {
      "type": "http",
      "url": "https://mcp.bot-trade.org/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

{
  "mcpServers": {
    "bottrade": {
      "url": "https://mcp.bot-trade.org/mcp"
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "bottrade": {
      "serverUrl": "https://mcp.bot-trade.org/mcp"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

Score

39 / 100

Incomplete

Documentation22/25
Maintenance19/25
Trust6/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 1 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
6 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
1.0.0Latest	Jul 10, 2026