Getting Started
Dive into the world of cutting-edge algorythmic trading with our powerful platform. Start by clearing the onboarding troubleshooting guide below so your first required simulation runs on clean, validated data, then choose your desktop platform and finish setup.
Resolve the three most common onboarding simulation blockers
Use this plain-language guide when the starter simulation stops before completion. Start with the code shown in BitThor, follow the non-technical steps below, and rerun the same request once the issue is cleared.
BitThor needs more historical candles before it can test this setup
The starter simulation needs at least 50 candles to warm up the indicators safely. If the selected history window is too short, BitThor stops early instead of showing a misleading result.
- Switch to a supported symbol with deeper bundled history, such as BTCUSDT or ETHUSDT.
- If you narrowed the candle window or changed the data source, widen it so the run includes at least 50 complete candles.
- Run the data check again before starting the sample simulation.
BitThor detected a settings change between review and simulation
This usually means the saved bot settings changed after the current page loaded. BitThor stops so you do not validate one configuration and activate another by mistake.
- Reload the bot or reopen the setup wizard so the latest saved settings are back in view.
- Confirm the symbol, indicator settings, and risk controls still match what you expect.
- Run the simulation again only after the refreshed settings are visible.
BitThor found a data or simulation-record integrity problem
BitThor stopped because the historical candles, simulation payload, or audit record did not pass an integrity check. This protects you from reviewing incomplete or inconsistent results.
- Refresh the page and rerun the onboarding data check so BitThor can request a clean dataset.
- If you imported or edited historical data, replace incomplete rows or switch to a bundled supported symbol.
- If the issue repeats, restart BitThor so the simulation audit store can be rebuilt cleanly before you continue.
From Simulation to Live: What to Expect When Deploying Your Bot
When you click View Live Trading Options after a successful simulation, BitThor opens the Deployment Readiness Check modal. This modal walks you through three server-side gates that must all pass before your bot can go live. You must acknowledge each step before proceeding.
Step 1 — Bot Configuration Hash Check
What happens: The server recomputes your bot’s configuration hash and compares it against the hash recorded when you ran the simulation.
Why it matters: This guarantees you are activating the exact configuration that was tested. Any change to your bot settings after the simulation invalidates the match.
If it fails: Deployment is blocked. Close the modal, review your bot settings, and re-run the simulation before trying again.
Step 2 — Activation Token & 5-Minute Window
What happens: When the hash check passes, the server issues a 5-minute activation token tied to this bot and session. If the same valid configuration is confirmed again within the window, the server returns the same token.
Why it matters: The time-limited token prevents a stale approval from being used after conditions have changed.
If it fails: If the window expires before you submit, close the modal and re-open it to begin a fresh validation pass.
Step 3 — Live Analyzer Connection Health
What happens: BitThor confirms that its live market analyzer is in an active, connected state before issuing the deployment token.
Why it matters: A bot activated before the analyzer is ready would miss market signals and potentially enter the market at the wrong time.
If it fails: Wait a moment for the connection to establish, then re-open the modal and try again.
All three gates passed — what happens next
Once you acknowledge all three steps and click Submit Deployment, the server activates your bot. Its status changes to Active and it immediately begins monitoring the market using the configuration and strategy settings from your simulation. The first real order will be placed the next time entry conditions are met on your exchange.
Understanding Signal Attribution
After a completed simulation, BitThor uses the read-only endpoint GET /api/v1/simulation/signal-breakdown/{sessionId} to populate the Simulation Summary Card's attribution layers. This endpoint returns the signal weights behind the run so you can inspect the raw component contributions that formed the final P&L and the educational Signal Impact Score summary.
Deep Dive: Signal Breakdown Data
Input: the sessionId from a completed simulation. Output: buy-side and sell-side weighting arrays, exact SignalName and SignalConfidence values, capped top-signal rows, total session P&L, signal diversity, and the historical weighting data used to explain the final result.
If the sessionId is invalid or the simulation record is missing, BitThor shows a placeholder reminder telling you to complete a simulation first before reviewing signal attribution data.
Download BitThor for Your Desktop
Get BitThor for your desktop and choose the platform that matches your machine before continuing.
Choose a platform before you continue · Version 0.0.89.4 · All versions →
Risk Disclosure: Cryptocurrency trading involves substantial risk of loss and is not suitable for every user. Review your bot settings carefully before live trading. BitThor provides software tools only and does not provide investment advice. ML-based forecasting and predictive signals are analytical tools only and are not guarantees of future performance or profit.
Review installation steps
After choosing your platform above, use the download page to review the .NET prerequisite and the full install flow for your operating system.
View install guide
Explore our Blog
Explore our comprehensive blog topics to get started and discover the full capabilities of BitThor. Our blog covers topics from initial setup to advanced features, including running options, ensuring you have all the information you need.
Explore the topics
View our FAQ
Checkout the FAQ section to learn about the most common asked questions and get up and running quickly.
FAQ
How It Works
Be sure to checkout this section to understand how BitThor works in the background.
Explore the topics