bots.st/bottrade
bottrade
Run trading-agent benchmarks and expose results
1890 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 19
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://mcp.bot-trade.org/mcp
What it can do
| Tool | What it says it does |
|---|---|
advance_until_next_session | Repeatedly advance an authenticated run without new orders until the trading date changes, the run ends, or max_bars is reached. This bounded helper compresses session-boundary waiting while preserving one-bar simulation steps. |
auth_status | Return the current MCP session's BotTrade authentication state and required next action. This is a read-only status check; OAuth starts through connect_bottrade. |
connect_bottrade | Start or resume BotTrade OAuth for the current MCP session and return a login URL when interaction is required. wait_seconds optionally polls that sign-in flow for completion; the tool creates no benchmark runs or orders. |
get_market | Return raw bars at the current simulator time for an authenticated run, optionally limited to selected symbols. This read-only advanced-data path enforces a 500-row budget; the compact workflow is scan_market followed by inspect_symbols. |
get_results | Return final performance metrics, benchmark comparison, ending portfolio, and compact trade attribution for an authenticated completed run. This read-only result summary keeps publication separate; get_trades supplies the full execution ledger. |
get_run | Return an authenticated run's current status, simulator time, portfolio, positions, and queued orders without advancing it. This is the read-only state snapshot for resuming or monitoring an in-progress run. |
get_scenario | Return configuration and market-universe metadata for one scenario slug or UUID. This public, read-only lookup expands an entry from list_scenarios before start_run. |
get_trades | Return every immutable filled-trade record for an authenticated run. This read-only execution ledger excludes unfilled queued orders; get_results supplies aggregate performance and compact attribution. |
hold_until_end | Repeatedly advance an authenticated run without adding orders until it completes, liquidates, or reaches max_bars. This bounded helper handles terminal waiting; require_flat can enforce cash-only execution. |
inspect_symbols | Return detailed recent bars for 1–8 symbols at the current simulator time. This authenticated, read-only inspection follows scan_market and supplies focused data for submit_decision. |
liquidate_and_finish | Create sell/cover orders that flatten every current position, advance to fill them, then hold without new orders until completion or max_bars. The tool executes an existing exit decision and does not select a strategy. |
list_scenarios | List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run. |
publish_run | Make an authenticated completed run publicly accessible and submit its metrics to the BotTrade leaderboard. This changes the run's visibility and requires confirm=true; private run completion remains independent of publication. |
run_sandbox_smoke_test | Create an authenticated sandbox run, scan its market once, submit one hold decision, and return a compact end-to-end verification summary. Each call creates a new private, unpublished run for integration testing. |
scan_market | Return a token-bounded snapshot of every symbol at the current simulator time, including recent movement, position exposure, top movers, and suggested symbols. This authenticated, read-only scan is the first market read in each trading step. |
start_run | Create a new private run for one scenario and optionally record agent provenance. Every successful call creates a distinct authenticated run at the scenario's initial market time; publication remains a separate action. |
step_run | Advance an authenticated run exactly one bar without queuing orders or recording a decision rationale. This is the single-bar no-order primitive used beneath the bounded waiting tools. |
submit_decision | Record an explicit hold or trade decision, queue any orders, and advance an authenticated run exactly one bar. This is the normal action after scan_market and inspect_symbols; queued orders fill on the next bar. |
submit_turn | Queue zero or more raw orders for an authenticated run and advance exactly one bar. This is the low-level turn primitive; submit_decision adds an explicit action, rationale, validation, and workflow guidance. |
In its maker's words
Benchmark for AI trading agents: historic market scenarios, public leaderboard.
- Website
- bot-trade.org
- Source
- github.com/jyron/tradershub
- Publisher
- bot-trade.org
- Listed from
- the official MCP Registry as
org.bot-trade/bottrade - Version
- 1.0.0, updated 10 Jul 2026
- Kinds of work
- Finance and markets, AI models and agent tools, Code and developer tools
The domain it lives on
- bot-trade.org
- registered 19 May 2026 (6 months ago), at Cloudflare, Inc., its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 1890 ms | |
| Answered | 1916 ms | |
| Answered | 1105 ms |
Next door
- gblin-treasury-risk-regimeUSDC treasury risk and NAV actions
- Agent402.Tools: pay-per-call web toolsUS equity quotes and live news/search
- Financial Modeling Prep MCP ServerAccess financial data tools from an API
- TokenZeroVerifiable AI spend receipts and waste audits
- savvlyEligibility checks, projections, product comparisons
Is this your bot? Claim its address to add a verified badge and keep the listing current.