Practical overview
When it fits
Use it when you need a buildable C++ starting point for crypto algorithmic-trading work or want to examine order-execution flows, including a network-free sandbox path.
Who it is for
- C++ developers building or studying cryptocurrency trading software
- Developers who want to explore order-execution code with a local sandbox before working with live exchange connectivity
Documented uses
- Configure and build the codebase for Debug or Release using Conan and CMake.
- Build and run the documented Catch2 tests.
- Smoke the CLI order flow through an in-memory sandbox executor without API keys.
- Study the ccapi-based live executor and its exchange-specific credential and symbol requirements.
Requirements & limits
The repository is public and licensed under MIT.
- The documented build workflow uses Conan, CMake and Ninja Multi-Config; Linux and macOS steps are in the README, while Windows has separate instructions.
- Building both Debug and Release requires Conan dependency generation for both configurations in the same build directory.
- The sandbox executor records order calls in memory and does not use ccapi or a network connection.
- Live exchange use relies on ccapi and requires credentials and symbol strings matching the selected venue.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build and run the sandbox CLI on Linux or macOS
Configure the repository and build the CLI example that records an order call in memory without network access.
Before you start
- Linux or macOS
- Python 3
- The repository's documented Conan and Ninja dependencies
- A GCC 12 profile matching the documented example, or an adjusted profile for another toolchain
Steps
Clone the repository, enter its directory, create and activate a Python virtual environment, and install the requirements file.
Detect a Conan profile and install the repository's Conan configuration.
Run the documented Conan install for the desired build configuration; for both Debug and Release in the Ninja Multi-Config tree, run both profile installs into the same build directory.
Source the generated Conan build environment and configure with
cmake --preset conan-default.Build the
execute_ordertarget, then run it with--sandbox --symbol BTC-USD --side buy --size 1 --type limit --price 100.
Expected outcome
The CLI invokes the sandbox executor, which records the order call in memory without using ccapi or a network connection.
Guide limitations
- The documented build commands cover Linux and macOS; Windows has separate instructions.
- The GCC profile commands are examples and may require adjustment for a different compiler or toolchain.
- This sandbox example does not submit a live exchange order.
Build and run the documented Catch2 tests
Build the test target and invoke CTest after configuring the project.
Before you start
- A configured project using the documented Conan and CMake workflow
- The default
BUILD_TESTINGsetting, which is ON - A Debug or Release build configuration
Steps
Configure using
cmake --preset conan-default.Build
heisenberg_testswithcmake --build build --config Debug --target heisenberg_tests --parallel, or substitute Release for Debug.From the build directory, run
ctest --output-on-failure -C Debug, or substitute Release to match the build.
Expected outcome
CTest runs the configured Catch2 test target for the selected build configuration.
Guide limitations
- The README says to configure with
BUILD_TESTING=OFFif the test target should be omitted. - The documented commands are build instructions, not a claim that the tests have been run or passed.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 8 October 2026
- Original website title
- profitviews/heisenberg · Official homepage title · retained in its source language