Skip to main content
Starbase API keys are created through the Starbase section of the Account Panel (not the API section). The creation flow is otherwise the same as standard Deribit API keys, but with a different set of available scopes and a required member setup step.
The Starbase section is only visible after your account has been authorized by a Deribit admin. If you do not see it in the dropdown, contact support@deribit.com.
Before creating a Starbase API key, you must first add at least one member. Only main accounts can configure members. API key creation is scoped to a member.
Starbase API key management is a sensitive operation. If your account has Two-Factor Authentication (2FA) enabled, you will be prompted for a security key confirmation. See Security Keys for details.

​
Front-end interface

1

Navigate to the Starbase Section

Head to the Starbase tab inside the top right Account Panel.The Starbase section is separate from the standard API section. Make sure you are in the correct tab.Starbase Section
2

Add a Member

Before you can create an API key, you must add a member. Click Add Member and fill in:
  • Member Name: a label for this member (e.g. New member)
  • Accounts: select which accounts (main account and/or subaccounts) this member should have access to Starbase Members List
Click Add Member to open the dialog:Add Member DialogOnce saved, the member will appear in the Starbase member list.
A Member is a Starbase-specific concept that groups one or more portfolios (accounts/subaccounts) into a single trading participant. See Account Model for a full explanation.
3

Create a New API Key

With a member selected, press Add new key to open the key creation dialog.Provide an optional Name for the key, then select one or more scopes from the following:
ScopeDescription
FIX Drop CopyReceive a consolidated drop copy of all activity on the portfolio via the FIX Drop Copy API
SBE Order EntrySubmit, amend, and cancel orders via the Simple Binary Encoding (SBE) Order Entry API
SBE Market DataSubscribe to market data via the SBE Multicast Market Data feed
REST Order EntrySubmit orders via the REST API
Create API Key DialogClick Create API Key to generate the key.
4

Save Your Credentials

Once created, you will receive a Client ID and Client Secret.API Key Created
The Client Secret is only shown once when the key is created. Store it securely, as you cannot retrieve it later.
For a description of what these credentials are, see the Client ID and Client Secret section of the Creating new API key guide.

​
API key limits

Each subaccount can have up to 8 Starbase API keys. Because each gateway connection requires its own API key, plan your key allocation based on the number of gateway connections you intend to maintain. Starbase API keys use a separate counter from standard Deribit API keys. Starbase API keys do not count toward your standard API key quota, and standard API keys do not count toward your Starbase quota.

​
Next steps

Gateway Connectivity

How API keys map to gateway connections and connection rules

Binary API Reference

SBE protocol structure, message headers, and data types

Placing a New Order

Submit your first order via the SBE Order Entry API

FIX Drop Copy API

Consolidated drop copy of all portfolio activity

Session Messages

Logon, logout, and heartbeat session message flows

Cancel on Disconnect

Automatic order cancellation on connection loss