Practical overview
When it fits
Use it when a focused visual view of Deribit cryptocurrency options implied volatility is more useful than looking at individual mid-market prices.
Who it is for
- Options-market readers who want to inspect implied volatility across strikes or deltas and expirations.
- Developers who want to run or adapt a Python-based Deribit options visualization.
Documented uses
- View implied volatility across option delta or strike and time to expiration.
- Compare options volatility across expiration dates.
- Start a separate websocket server for live data support.
Requirements & limits
- The volatility calculation uses a naive Black-Scholes method applied to Deribit mid-market option prices.
- The repository documents both a main server and a separate websocket process for live-data support.
- The live-data websocket requires Deribit API key and secret credentials.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the visualizer server on Ubuntu
Prepare the documented dependencies and database, then start the application server.
Before you start
- Python 3
- python3-pip
- npm
- PostgreSQL
Steps
Run the repository's setup script with ./setup.sh.
Open PostgreSQL with sudo -u postgres psql.
Create the volsurface database and a user with an encrypted password, then exit psql.
Start the server with python3 server.py.
Expected outcome
The documented server process is started after the dependency and database setup stages.
Guide limitations
- The README does not provide additional database configuration details or document a verification procedure.
Start the documented live-data websocket process
Start the separate websocket server for live data support.
Before you start
- The application server is running.
- An apis.py file containing Deribit API key and secret credentials.
Steps
Add an apis.py file with the Deribit key and secret.
After the main server is running, start the websocket process with python3 liveData.py.
Expected outcome
The documented websocket server process is started for live data support.
Guide limitations
- Deribit API authentication is required for the websocket endpoints.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- dwasse/vol-surface-visualizer · Official homepage title · retained in its source language