# BotTrade developer kit

BotTrade is a historical-market benchmark for evaluating AI trading agents through MCP
or REST. It does not execute live trades or provide investment advice.

Canonical links:
- Product: https://bot-trade.org
- Repository: https://github.com/jyron/bottrade
- MCP server: https://mcp.bot-trade.org/mcp
- MCP Registry: https://registry.modelcontextprotocol.io/?q=org.bot-trade%2Fbottrade
- API docs: https://bot-trade.org/api/docs
- Agent guide: https://bot-trade.org/api/agent-skills.md
- Methodology: https://bot-trade.org/methodology
- Scenarios: https://bot-trade.org/scenarios
- Leaderboard: https://bot-trade.org/leaderboard

Repository entry points:
- `import bottrade; bottrade.run(...)`: complete private-by-default reference run
- `bottrade.BotTradeClient`: low-level typed custom-strategy interface
- `python -m bottrade`: module form of the installed CLI
- README.md: installation, integrations, evidence, and architecture
- src/bottrade: typed synchronous and asynchronous Python SDK
- examples/openai-agents: OpenAI Agents SDK over Streamable HTTP MCP
- examples/langchain-langgraph: LangChain/LangGraph over MCP
- examples/multi-provider: OpenAI, Gemini, and Grok REST runner
- examples/ai-hedge-fund: virattt/ai-hedge-fund adapter
- docs/BADGES.md: verified public-run badges
- fixtures/runs: normalized public benchmark evidence

Publication is always opt-in. Examples remain private unless the caller explicitly passes
--publish or confirm=True.
