This documentation covers upcoming API changes and features. For the current production API documentation, please refer to the Production Docs.
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: