Two versions of the API documentation are available. You can switch between them using the version selector button at the top of the page. Changes in the upcoming version will be available in the production version after the next release. For release notes and information about upcoming releases, visit the Releases section.
API Interfaces
Deribit provides three different interfaces to access the API:JSON-RPC over WebSocket
Real-time, bidirectional communication. Recommended for most use cases.
JSON-RPC over HTTP
Simple REST-like interface for HTTP requests.
FIX API
Financial Information eXchange protocol for institutional trading.
Get Started
Quickstart Guide
Get up and running in minutes with our step-by-step quickstart guide. Make your first API call and start building.
Core Concepts
Authentication
Learn how to create and manage API keys, and authenticate your requests.
Rate Limits
Understand rate limits, credit system, and how to optimize API usage.
Access Scopes
Learn about API permissions and access scopes for controlling what operations your API keys can perform.
Notifications
Subscribe to real-time market data and account updates.
Error Codes
Reference guide for all API error codes and error handling.
API Console
Interactive API testing tool for exploring and testing API methods.
Environments
Deribit provides separate test and production environments. All examples in this documentation use the test environment (
test.deribit.com). Test and production require separate accounts and API keys.Test Environment
Purpose: Development and testingHTTP Endpoint:
https://test.deribit.com/api/v2WebSocket Endpoint: wss://test.deribit.com/ws/api/v2Links:Production Environment
Purpose: Live tradingHTTP Endpoint:
https://www.deribit.com/api/v2WebSocket Endpoint: wss://www.deribit.com/ws/api/v2Links: