Practical overview
When it fits
Use it when you want a code-based workflow to test DeFi strategies against historical snapshots and the repository’s supported data sources and position simulators fit your use case.
Who it is for
- Developers writing and evaluating DeFi trading strategies in TypeScript.
- Researchers or protocol teams comparing strategy behavior over historical data, where a listed source and simulator cover the markets they need.
Documented uses
- Configure historical data sources, a testing period and handlers for a backtest.
- Simulate opening, changing and closing supported DeFi positions as the backtest progresses.
- Store and visualize results using the optional local InfluxDB and Grafana setup.
- Inspect strategy metrics and analytics.
Requirements & limits
The repository is public and licensed under MIT. It is a library intended to run from a local development environment, not a hosted application. The README documents npm dependency installation and ts-node commands; it does not identify required runtime versions.
- Data-source coverage is limited and varies by chain, protocol and resolution; check the README’s support table before planning a backtest.
- Position simulators and the project API are described as early-stage and subject to change.
- InfluxDB and Grafana are optional for strategy testing, while the larger example requires Influx.
- The README marks the NPM module, wallet support for simulators and local data caching as unavailable.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the simple sample backtest
Install the project dependencies and run the repository’s simple TypeScript sample.
Before you start
- A local copy of the repository
- Node.js tooling capable of running npm and ts-node
Steps
Install dependencies with the command below.
npm installRun the sample with
ts-node ./src/simple.ts.
Expected outcome
The documented simple sample backtest runs from the repository.
Guide limitations
- The README warns that the project is in early development and its API may change.
- The README does not specify Node.js or npm version requirements.
Start local Grafana and InfluxDB services
Launch the optional local services used to store and visualize backtest data.
Before you start
- Docker and Docker Compose
- A local copy of the repository with its
docker-compose.ymlfile
Steps
From the repository, run
docker-compose up -d.After use, stop the containers with
docker-compose down -v.
Expected outcome
The repository’s Docker Compose setup starts local InfluxDB and Grafana services for backtest data and visualization.
Guide limitations
- These services are not required to test strategies; the larger example requires Influx.
- A fresh Grafana instance has no dashboards and needs data-source configuration; the README describes importing provided dashboard JSON files.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- RoboVault/web3-backtest · Official homepage title · retained in its source language