Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.deribit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Starbase Release 06.05.2026 — v1.0

​
Starbase Release

​
Key Dates & Access

  • July 13th: Member and API key creation will become available in the UI, along with four SBE Order Entry endpoints for connectivity testing: Logon, Logout, Heartbeat, and Test. Access to market data and FIX drop copy will also be granted on this date. Multicast market data feeds will begin propagating to client servers within LD4, AWS eu-west-2 and AWS ap-northeast-1 for all derivatives.
  • July 20th (Go-Live): Clients will receive full access to the SBE Order Entry gateway for all derivatives.

​
Equalization

Due to hardware shortages and delivery delays, equalization of all connections for trading on Starbase is expected before the end of August. The maximum possible latency difference between the fastest and slowest member is <5 microseconds, depending on the length of the cross connects. Equalization will involve migrating existing cross connects; no new cross connects are necessary. Because Deribit’s hosted co-location uses very short cables to the edge switch, hosted co-location is expected to be a few microseconds faster than cross connects during July and some parts of August.

​
Stability

Starbase’s test environment has performed stably for two consecutive weeks and is well positioned to support technical integration.

​
Introduction of ETH to Starbase’s test environment

Inverse and linear ETH products have been migrated from the legacy matching engine to Starbase on test.deribit.com. The following products are now matching on Starbase in the test environment:
  • Linear ETH options, futures and the perpetual (options and futures with a 10ms speed bump)
  • Inverse ETH options, futures and the perpetual (options and futures with a 10ms speed bump)
  • AVAX options, futures and perpetual (all with a 10ms speed bump)
  • PAXG perpetual
All BTC products remain on the legacy matching engine.

​
REST gateway

A REST API with utility endpoints is now available. Notable endpoints include:
  • Platform-wide mass cancellation: allows cancellation of all open orders across the platform.
  • Subaccount lock: enables you to completely lock Starbase APIs from accessing a specific subaccount. This endpoint also cancels all open orders and will be made available over the internet.

​
Environment resets

In the coming weeks, engineers may trigger resets of Starbase’s test environment. These resets will cause only brief downtime and will not reset any credentials or configurations. However, they will disconnect open connections and wipe all open orders and related histories. Please reach out to your account manager to be notified in advance of any resets.

​
Documentation updates

Now that Starbase has stabilized, the SDK and PCAPs will be versioned with the version and semanticVersion from the XML messageSchema. The latest version and semanticVersion will appear on the specification pages.

​
API Changes

​
Market Data

Instrument message has been renamed to InstrumentDefinition and redesigned:
  • New fields added: indexId, underlying, quantityAsset, priceAsset, minOrderQuantity
  • Removed fields: symbol, baseCurrency, quoteCurrency, baseIncrement, creationTime, logicalExpiry
  • Large tick size information is now represented as a repeating largeTickSizes group instead of flat fields
  • A new repeating legs group has been added to support combo instruments
New IndexDefinition message added, providing indexId and name for each index.Message ID changes:
  • TradingStatusUpdate has been removed and replaced by InstrumentStatusUpdate
  • InstrumentInfo and InstrumentRef have been renumbered
sortOrderId field added to Buy Put and Sell Put messages.TradeSummary message redesigned:
  • impliedVolatility field removed
  • tradeCount field added — indicates the number of Trade messages following the summary
  • takerFlags field renumbered

​
Order Entry

New CancelReason values:
  • PORTFOLIO_LOCKED — order cancelled because the portfolio is locked
  • POST_ONLY — post-only order would have crossed
New OrderRejectReason values:
  • PORTFOLIO_LOCKED — order rejected because the portfolio is locked
  • POSITION_LIMIT_EXCEEDED — future or options position size limit exceeded
  • ORDER_SIZE_LIMIT_EXCEEDED — open order aggregate size limit exceeded
New MassQuoteRejectReason value:
  • PORTFOLIO_LOCKED — mass quote rejected because the portfolio is locked
​
Announcement 17.04.2026

​
Announcement

Thank you to everyone who has already started trading on the Starbase test environment — members have logged on and sent, amended, and cancelled orders, including mass quotes.

​
Documentation and downloads

Refreshed XMLs, PCAPs and SDKs can be found on the Binary API Reference page. Updated documentation is available across the Starbase section.

​
Multicast

Nothing will change for the current production multicast feeds — they will continue as-is under all circumstances. To receive the new Starbase multicast feeds:
  1. Deribit-hosted colo servers: No changes needed. Send an IGMP join for the multicast feeds you want to consume.
  2. Cross-connected clients: PIM configuration with an RP is required. For configuration details, contact colo-support@coinbase.com.
  3. Third-party clients (Beeks, UltraFX, LiquidityConnect, AWS): Setup is in progress. You will be notified when connectivity is verified and ready.
Since only AVAX/USDC and PAXG/USDC instruments have been migrated, not every multicast channel has market data flowing yet. To test connectivity, use channel 224.0.12.234, which includes all AVAX options. All channels are listed on the Multicast Channels page. A table mapping underlyings to tiers is also available.For any questions or concerns, contact colo-support@coinbase.com.
​
Announcement 08.04.2026

​
Announcement

Starbase is now live on test.deribit.com. Starbase is Deribit’s new matching engine, which unlocks throughput of more than 100k orders per second with submillisecond latencies, and will be the home of all of Coinbase’s international derivatives. To learn more, see the Starbase overview.

​
Instruments on Starbase (test.deribit.com)

The following instruments are currently handled by Starbase:
  • PAXG_USDC-PERPETUAL
  • AVAX_USDC-PERPETUAL
  • All AVAX_USDC dated futures
  • All AVAX_USDC options
All other instruments operate on the legacy matching engine. Starbase is under active development, so improvements will be added to the test.deribit.com deployment often and without notice.

​
Connecting

  1. Contact your Deribit account manager via Telegram or Slack with your test.deribit.com main account user ID. They will enable direct access for all underlying subaccounts.
  2. Create a Starbase API key.
  3. Use the connectivity details below for order entry and market data.
No changes are required for existing cross-connects or other direct connections. Full connectivity details are available on the Gateway Connectivity page.

​
SDK and specifications

The latest SDK is available for download. XML schemas for the SBE APIs are included with the SDK release.Starbase remains on track to go live on Deribit’s production environment for all derivatives in the first half of July.
​
Announcement 11.03.2026

​
Announcement

Starbase will replace some order books on test.deribit.com on April 8th. On that date:
  • Members can create API keys to authenticate against Starbase using the existing API key creation UI on test.deribit.com.
  • Members will receive an email with the IPs of the gateways and the usable ports.
  • Market data will be published on the multicast channels.
  • That same email will include a list of instruments whose order books have been migrated to Starbase.
  • XML specs for the SBE APIs will be made available.
FIX Drop Copy specifications are now available. A Python SDK (.whl) is also available to kickstart integration of the Starbase order entry and market data APIs.
​
Announcement 01.02.2026

​
Announcement

A change in company strategy has led to changes in technology and timelines, driven by the decision to align with other Coinbase exchanges.

​
What won’t change

All existing APIs will continue to work throughout the ME replacement. The physical location and network connectivity won’t change, and the tradeable contracts will stay the same. Unless you care about performance, you won’t notice a thing.

​
Timelines

  • Early April: A test environment will be made available.
  • Early June: We will start rolling out direct access.
  • August: Every order book will have moved over and every direct access API will be available.

​
Starbase specifications

The new matching engine, Starbase, comes with a low-latency order entry API and multicast market data feed. The specifications are available here. Other key information:This is made available early to allow for feedback and to help with planning your integration.

​
Coming soon

  • FIX Drop Copy specifications will be made available next month
  • A REST API with utility endpoints will be made available next month
  • XML specs of the SBE and FIX APIs will be available before the test environment is live
  • PCAPs of all APIs will be available before the test environment is live
  • Code examples will be available before the test environment is live
Minor updates to the APIs can be expected as designs are adapted based on member feedback.