Deribit
Coming SoonCrypto — Derivatives
connectorType: "deribit"Leading crypto options & futures exchange
Connection Architecture
Deribit
WebSocket / REST→
Connector
libs/exchange-deribit→
Provider
:8081/api→
Detector
Advisor
Studio
The connector receives data from the exchange and feeds it to Provider (port 8081). From there — to Detector, Advisor, and Studio.
Technologies
Transport
WebSocketREST
Authentication
Client ID + SecretData Format
JSONFeatures
OAuth2
Best for
- Volatility traders and options desks requiring programmatic access to BTC and ETH options chains with Greeks.
- Quantitative funds building delta-hedging or volatility-arbitrage strategies across options and perpetual futures.
- Institutional participants needing portfolio margining and block trade execution for large notional positions.
- Researchers and data engineers extracting implied volatility surfaces and funding rate time-series for model calibration.
Connect via code
1Environment variables (.env)
DERIBIT_CLIENT_ID=your_key_here DERIBIT_CLIENT_SECRET=your_secret_here
2Connector configuration
// config/config.provider.json
{
"provider": {
"connectors": [
{
"connectorType": "deribit",
"enabled": true,
"key": "${DERIBIT_CLIENT_ID}",
"secret": "${DERIBIT_CLIENT_SECRET}",
"markets": [
{ "marketType": "spot", "symbols": [{ "name": "BTCUSDT" }] }
],
"subscriptions": [
{ "type": "PROVIDER_MARKETDATA_CANDLE", "symbols": ["BTCUSDT"], "intervals": ["min1", "h1"], "active": true },
{ "type": "PROVIDER_MARKETDATA_TRADE", "symbols": ["BTCUSDT"], "active": true },
{ "type": "PROVIDER_MARKETDATA_ORDERBOOK", "symbols": ["BTCUSDT"], "active": true }
]
}
]
}
}3Verify and query data
# Verify connection curl -H "Authorization: Bearer $PROVIDER_API_TOKEN" \ https://localhost:8081/api/exchanges/runtime-proof # Candles (last 7 days) curl -H "Authorization: Bearer $PROVIDER_API_TOKEN" \ "https://localhost:8081/api/candles/deribit/spot/BTCUSDT/h1?days=7"
Available via Barfinex API
/api/candles/deribit/...
/api/trades/deribit/...
/api/orderbook/deribit/...
/api/account/deribit/...
/api/symbols/deribit/...
/api/assets/deribit/...
Studio graphical setup — in development, coming in the next release.
Important
Deribit uses client_id and client_secret for OAuth2 authentication — the quickSetupEnv KEY field maps to client_id, SECRET maps to client_secret.
This connector covers futures and options markets only; Deribit does not offer spot trading.
Deribit operates on a 24/7 schedule but settlement events (options expiry every Friday at 08:00 UTC) cause brief liquidity gaps — avoid scheduling large orders around expiry.
A testnet is available at test.deribit.com with free paper-trading funds; validate all strategy configurations there before going live.
Portfolio margin mode requires a minimum account equity threshold set by Deribit — confirm eligibility before enabling it in your connector config.
Connect in Studio(soon)
Exchange Website