Deribit Trading System is a high-performance order execution and management system that operates through a command-line interface. It uses a WebSocket client to connect to the Deribit TESTNET and manage trading portfolios with advanced functionality.

• WebSocket-based trading interface
• Command-line trading operations
• Support for various order types
• API authentication
• Open orders management
• Order modification and cancellation

• C++ Compiler (g++)
• CMake
• Boost Libraries
• OpenSSL
• Git

To quickly configure your system and set up the project, please go ahead and execute the appropriate setup script for your operating system as detailed below.

• NOTE: Please make sure you are in the repository's root directory before running the script.

Run the following commands to execute the setup script:

chmod +x ./scripts/setup_mac.sh
./scripts/setup_mac.sh

Run the following commands to execute the setup script:

chmod +x ./scripts/setup_linux.sh
./scripts/setup_linux.sh

For Windows, use the PowerShell script as follows:

Set-ExecutionPolicy Bypass -Scope Process -Force
.\scripts\setup_windows.ps1

This will install the necessary dependencies, build the project, and prepare it for use.

1. Install Homebrew (if not already installed):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install dependencies:

brew install cmake gcc boost openssl git readline

1. Update package list:

sudo apt update

2. Install dependencies:

sudo apt install cmake gcc libboost-all-dev libssl-dev git libreadline-dev

1. Download and Install:
   • CMake
   • Git
   • Visual Studio Build Tools
   • Boost Binaries
   • OpenSSL

1. Clone the Repository:

git clone https://github.com/Venkatesan-M/deribit-trading-system.git
cd deribit-trading-system

2. Create Build Directory:

mkdir build
cd build

3. Build the Project:

cmake .. -Wno-dev
cmake --build .

4. Run the Application:

./deribit_trader

This is a trading system for educational and testing purposes. Always use caution and understand the risks involved in cryptocurrency trading.

1. Create an account on Deribit Testnet

2. Generate API Keys:
   • Navigate to Account Settings
   • Create API Key
   • Set permissions (read/read_write)
   • Save Client ID and Client Secret securely

• help / man: Show all supported commands
• quit / exit: Close WebSocket connections and exit
• close <id> [code] [reason] : Closes the connection with the given id; optional: specify exit code and/or reason
• connect <URI> : Creates a connection with the given URI
• show <id>: Get connection metadata
• send <id> msg: Send message to specific connection
• show_messages <id>: View message exchanges
• send <id> <message>: Sends the message to the specified connection
• view_subscriptions: Displays the list of subscribed symbols to stream continuous orderbook updates
• view_stream: Displays the stream continuous orderbook updates subscribed symbols
• latency_report : Generates a latency report of the current session
• reset_report : Delete's the data of the latency report of the current session

1. Connect to Testnet: Creates a new connection to the Deribit testnet website

Deribit connect

connect wss://test.deribit.com/ws/api/v2

2. Authenticate: Sends the authorization message to retrieve the access token; optional: use -s to remember the token for the session

Deribit <id> authorize <connection_id> <client_id> <client_secret> [-s]

1. Buy Order: Places a buy order for the specified instrument

Deribit <id> buy <instrument> <transaction_name>

2. Sell Order: Places a sell order for the specified instrument

Deribit <id> sell <instrument> <transaction_name>

3. Modify Order: Modifies the price or amount of an active order

Deribit <id> modify <order_id>

4. Cancel Order: Cancels the specified order

Deribit <id> cancel <order_id>

Cancell all orders

Deribit <id> cancel_all

1. Get Open Orders: Fetches all open orders with optional filters

Deribit <id> get_open_orders [<currency>] [<instrument>] [<label>]

2. View Positions: Fetches all your current open positions; optional: use options to be specific

Deribit <id> positions [currency] [kind]

3. Get OrderBook: Fetches all current buy and sell orders for the specified instrument; optional: specify depth of search

Deribit <id> orderbook <instrument> [<depth>]

1. Subscribe to a symbol: Subscribes to that symbol to stream continuous orderbook updates

Deribit <id> subscribe [symbol]

2. Unsubscribe to a symbol: Unsubscribes to that symbol to stream continuous orderbook updates

Deribit <id> unsubscribe [symbol]

3. Unsubscribe to all symbol: Unsubscribes to all symbols that have been subscribed to stream real time data

Deribit <id> unsubscribe_all

├── include # Header files
│   ├── api
│   │   └── api.h
│   ├── authentication
│   │   └── password.h
│   ├── json
│   │   └── json.hpp
│   ├── utils
│   │   └── utils.h 
│   └── latency
│       └── tracker.h
│   └── websocket
│       └── websocket_client.h
├── README.md
├── setup.sh
└── src
    ├── main.cpp # main function (deribit trader)
    ├── api
    │   └── api.cpp # Implementation Deribit API's Functionality
    ├── authentication
    │   └── password.cpp # Authentication and Session Management Functionality
    ├── latency
    │   └── tracker.cpp # Latenct tracking logic
    ├── utils
    │   └── utils.cpp # Helper functions and utils
    └── websocket
        └── websocket_client.cpp # websocketpp and WebSocket endpoint implementation

1. you are free to develop more feature on this, just refer the new DERIBIT API DOCS
2. Test the API Call on Deribit API Console

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Submit a pull request

MIT License

Copyright (c) 2025 Venkatesan M