deribit-trading-sdk 0.1.1

The unofficial Deribit API SDK, by Tribulnation. Compatible with Trading SDK.

Deribit Trading SDK

The unofficial, fully-typed async Python SDK for Deribit, by Tribulnation.

Read the docs

Quick Start

pip install deribit-trading-sdk

from deribit import Deribit

async with Deribit.new(API_KEY, API_SECRET) as client:
  candles = await client.buy('BTC_USDT', {
    'price': '50000',
    'quantity': '0.001',
    'type': 'LIMIT',
    'side': 'BUY',
  })

Why Deribit SDK?

• 🚀 Fully Async - Built with httpx for high-performance async operations
• 🔒 Type Safe - Complete type annotations with TypedDict and pydantic validation
• ⚡ Easy to Use - Simple context-managed API with async with
• 📊 Comprehensive - Spot trading, market data, wallet, and WebSocket streams
• 🎯 No Setup Required - Start exploring markets immediately

What's Included

• Market Data - Real-time prices, order books, and historical data
• Spot Trading - Place, cancel, and query orders
• User Data - Account balances, trade history, and order status
• Wallet Operations - Deposits, withdrawals, and address management
• WebSocket Streams - Live market data and user notifications

Authentication

Get your API keys from the Deribit dashboard.

Or, you can use public methods:

from deribit import MarketData

async with MarketData.new() as client:
  r = await client.get_order_book('BTC_USDC')

Supported APIs

The SDK covers the following Deribit endpoints:

Account

• get_account_summary
• get_account_summaries

Market Data

• get_contract_size
• get_index_price
• get_instrument
• get_instruments
• get_last_trades_by_instrument
• get_order_book

Private Subscriptions

• user_orders
• user_trades

Public Subscriptions

• depth_updates
• depth
• trades

Trading

• buy
• cancel
• cancel_all_by_currency_pair
• cancel_all_by_currency
• cancel_all_by_instrument
• cancel_all_by_kind_or_type
• cancel_all
• cancel_by_label
• edit
• edit_by_label
• get_open_orders
• get_open_orders_by_currency
• get_open_orders_by_instrument
• get_open_orders_by_label
• get_order_state
• get_order_state_by_label
• get_user_trades_by_currency
• get_user_trades_by_instrument

Wallet

• get_current_deposit_address
• get_deposits
• get_withdrawals
• withdraw