SabrTrader Documentation

Connecting Coinbase to SabrTrader

This page explains how to connect a Coinbase account to SabrTrader using an API key and secret, so that live crypto market data is available for charts and order-flow tools. The workflow covers preparing the SabrTrader Control Panel, adding a Coinbase connection profile, generating a correctly configured API key inside Coinbase, saving credentials, connecting, and opening a first chart. The same general process applies to most crypto exchanges, with small per-exchange differences noted where they matter.

Overview

This guide covers connecting a Coinbase spot account to SabrTrader through Coinbase's API. A data feed connection is a live link between SabrTrader and an exchange or data provider that supplies market prices. Coinbase, when connected with trading permissions enabled, provides both market data and account access for the assets you hold.

The connection is created in two places that must agree with each other: inside Coinbase, where you create an API key with specific permissions and a specific signature algorithm; and inside SabrTrader, where you paste that key and secret into a connection profile and connect.

The steps here apply broadly to other crypto exchanges as well. In every case you are looking for an API key and an API secret. The subtle per-exchange differences matter: for Coinbase specifically, you must switch the signature algorithm from the recommended option to the legacy software development kit (SDK) setting, or the connection will fail.

Prerequisites

  • An established Coinbase account with funded capital.
  • SabrTrader installed and opened at least once.
  • Access to the Coinbase settings and API page (Settings > API).
  • A secure place to store the credentials file Coinbase generates.

The Control Panel, Connections, and Coinbase feeds

The Control Panel (Control Center) is the primary SabrTrader window that hosts platform-wide functions: the Connections manager, workspace management, and the launcher for new charts and panels.

When you first install and open SabrTrader, a default workspace appears. A workspace is a saved layout of charts, DOMs and panels bound to specific connections. The default workspace exists only to give new users something to explore; it is fully modular and can be rearranged or closed. Because none of its contents are needed to make a Coinbase connection, close the default workspace first so the Control Panel is the sole focus.

The Connections manager

The Connections area contains SabrTrader's 57 preconfigured broker and data-feed configurations, your saved connection profiles, and the Add, Save Profile, Connect and Disconnect controls plus a connection status indicator. The preconfigured entries are templates only; they do not become usable until you add one to create a working profile.

The list you saw with several active feeds under a category represents personally connected profiles, not defaults. A fresh install shows the templates and, out of the box, a dxFeed connection that provides delayed prices so new users see data immediately. dxFeed can be disconnected when you do not need it.

SabrTrader Connections panel listing preconfigured broker and data feeds with connect controls.
The Connections manager in the Control Panel, showing SabrTrader's 57 preconfigured broker and data-feed templates alongside the connect controls.

Crypto category: spot versus perps

Inside the Connections list, the Crypto category groups the crypto exchange feeds. For Coinbase, SabrTrader makes an explicit distinction between two entries:

  • Coinbase spot for for immediate delivery at current prices.
  • Coinbase perps he derative contracts (perpetual futures) with no expiry date, used to speculate on price.

This guide demonstrates the spot connection. Choose the entry that matches the market you intend to trade or chart.

Crypto category in SabrTrader Connections showing Coinbase spot and perps entries.
The Crypto category expanded, showing the distinction between the Coinbase spot and Coinbase perps entries.

Key concepts and credentials

Understanding these terms makes the connection process unambiguous.

Term Definition
API key A public identifier that authenticates SabrTrader with your Coinbase account.
API secret A private credential paired with the API key that authorizes data and trading access. Treat it like a password.
Signature algorithm (SDK) The cryptographic method Coinbase uses to sign API requests. SabrTrader requires the legacy SDK setting rather than Coinbase's "Recommended" default.
IP whitelist An optional security setting that restricts API access to specified IP addresses. Left blank for this setup.
Spot market A market where crypto assets are traded for immediate delivery at current prices.
Perpetual futures (perps) Derivative contracts without an expiry date used to speculate on crypto price.
BTC/USD pair The trading pair quoting Bitcoin priced in US dollars.
Timeframe / bar interval The duration each candle or bar represents on a chart, such as 15 minutes.

The API key and secret together replace your Coinbase password inside SabrTrader. SabrTrader never sees or stores your login; it authenticates only with the key and secret you provision.

Adding a Coinbase connection profile

In the Connections manager, expand the Crypto category and highlight Coinbase (the spot entry). When you highlight the preconfigured template, its detail fields appear on the right, but they are locked and cannot be edited. This is expected: the template is read-only until you add it as a profile.

Click Add (below the list). SabrTrader creates a working profile named new Coinbase. Only now do the API key and API secret fields become editable. This two-step behavior highlight, then Add is a common source of confusion; you cannot type into the fields until the profile has been added.

New Coinbase connection profile in SabrTrader with API key and secret input fields.
The newly added 'new Coinbase' profile with editable API key and API secret fields.

Leave the new profile open. You will return to it after generating credentials in Coinbase.

Creating the API key in Coinbase

Switch to a browser and sign in at coinbase.com. This assumes you already have an established, funded Coinbase account.

  1. Open Settings.
  2. Scroll to API and click it.
  3. Click Create API key.
  4. Give the key a descriptive name (for example, saber or leave the default primary). The name is for your reference only.
  5. Enable all four permission checkboxes. Every one of the four permissions must be checked. Missing even one causes the connection to fail or limits functionality.
  6. Leave the IP whitelist field blank for a standard desktop setup.
  7. Change the signature algorithm from Recommended to the legacy SDK (software development kit) option. This is the single most important and most commonly missed step. If you leave it on Recommended, SabrTrader cannot sign requests and the connection will not work.
  8. Confirm the key creation.
Coinbase API key creation page showing permissions checkboxes and the legacy SDK signature algorithm setting.
The Coinbase API key creation screen with all four permissions checked, IP whitelist blank, and the signature algorithm set to legacy SDK.

The combination that works is: descriptive name + all four permissions checked + IP whitelist blank + legacy SDK signature algorithm.

Saving the credentials file

When the key is created, Coinbase generates and downloads a text file containing your API key and your API secret. This is your only opportunity to capture the secret, so save the file somewhere secure (a password manager or encrypted store is ideal). If you lose the secret, you must delete the key and create a new one.

Entering credentials and saving the profile

Return to SabrTrader with the new Coinbase profile still open.

  1. Open the downloaded credentials text file.
  2. Copy the API key and paste it into the API key field.
  3. Copy the API secret and paste it into the API secret field.
  4. Rename the profile to something descriptive, such as Coinbase spot, so it is easy to identify later.
  5. Click Save Profile. This persists the credentials so you never have to paste them again on subsequent sessions you simply select the profile and click Connect.
  6. Click Connect.
Entering Coinbase API key and secret into SabrTrader and naming the connection profile.
Pasting the API key and secret into SabrTrader and naming the profile 'Coinbase spot' before saving.

If everything is configured correctly, SabrTrader connects automatically and the status indicator shows the profile as connected. There is no additional login prompt because the key and secret already carry the authorization.

SabrTrader Connections manager showing the Coinbase profile connected.
The Coinbase profile showing a successful connected state after clicking Connect.

Step-by-step tutorial

The consolidated walkthrough from an empty Control Panel to a live connection:

  1. Open SabrTrader. Close the default workspace so the Control Panel is the only focus.
  2. Open the Connections manager in the Control Panel.
  3. Disconnect the out-of-the-box dxFeed feed if you do not need it.
  4. Expand the Crypto category and highlight Coinbase (spot).
  5. Note the detail fields are locked; click Add to create a new Coinbase profile.
  6. In a browser, go to Coinbase > Settings > API > Create API key.
  7. Name the key, check all four permissions, leave IP whitelist blank.
  8. Switch the signature algorithm from Recommended to legacy SDK.
  9. Create the key; save the downloaded credentials text file securely.
  10. Back in SabrTrader, paste the API key and API secret into the new profile.
  11. Name the profile (e.g. Coinbase spot) and click Save Profile.
  12. Click Connect. Confirm the status indicator shows connected.

Opening your first chart

With Coinbase connected, open a chart to confirm live data:

  1. Open the Chart creation dialog from the Control Panel.
  2. Choose the symbol for this example, the BTC/USD pair (Bitcoin quoted in US dollars).
  3. Set the timeframe / bar interval to 15 minutes.
  4. Set the history depth to roughly 21 days.
  5. Click Create Chart.
SabrTrader chart creation dialog set to BTC/USD, 15-minute interval, 21 days of history.
The chart creation dialog configured for the BTC/USD pair on a 15-minute timeframe with roughly 21 days of history.

A live 15-minute Bitcoin chart appears, streaming from Coinbase. From here you can add indicators and order-flow tools; those are covered on their own pages such as the Footprint chart and Volume Profile.

Live 15-minute BTC/USD candlestick chart in SabrTrader fed by Coinbase.
The resulting live 15-minute Bitcoin chart streaming from the Coinbase connection.

Best practices

  • Store the credentials file securely. The API secret is shown only once at creation. Keep the downloaded text file in a password manager or encrypted location.
  • Use descriptive profile names. Naming the profile Coinbase spot (versus Coinbase perps) prevents connecting to the wrong market.
  • Always click Save Profile before Connect. Saving persists your key and secret so you never have to re-enter them.
  • Verify the SDK signature setting. Before assuming anything else is wrong, confirm the Coinbase key uses the legacy SDK algorithm.
  • Confirm all four permissions. A single unchecked permission can silently limit or break the connection.
  • Create one key per platform so you can revoke access for a single application without disrupting others.

Common mistakes

  • Leaving the signature algorithm on Recommended. SabrTrader requires the legacy SDK setting. This is the most frequent cause of a failed Coinbase connection.
  • Missing one of the four permission checkboxes. All four must be enabled at key creation. Editing an existing key may not fix it recreate the key if unsure.
  • Forgetting to click Save Profile. Without saving, credentials are not persisted and you will have to paste them again, or the connect attempt may not use them.
  • Trying to edit fields before Adding the profile. The highlighted template is locked; you must click Add to create the editable new Coinbase profile first.
  • Losing the credentials text file. The secret cannot be retrieved after creation. If lost, delete the key and create a new one.
  • Connecting the wrong entry. Selecting Coinbase perps when you intend to trade spot (or vice versa) charts a different market.

Frequently Asked Questions

What is the difference between Coinbase spot and perps in SabrTrader?

Coinbase spot is the market where crypto assets are bought and sold for immediate delivery at current prices trading real coins such as Bitcoin against USD. Coinbase perps refers to perpetual futures: derivative contracts with no expiry date used to speculate on price. SabrTrader lists them as separate entries under the Crypto category, and you connect whichever matches the market you intend to chart or trade. This guide demonstrates spot.

Do I need to set an IP whitelist for the Coinbase API key?

No. The IP whitelist is an optional security setting that restricts API access to specific IP addresses. For a standard desktop setup you can leave it blank. Only add IP addresses if you have a fixed public IP and want to further restrict access.

Why does my Coinbase connection fail in SabrTrader?

The most common cause is leaving the signature algorithm on "Recommended" instead of switching it to the legacy SDK setting. Other causes include not enabling all four permission checkboxes, an expired or deleted key, or an incorrectly pasted key or secret. Recreate the key with the legacy SDK algorithm and all four permissions if in doubt.

Which signature algorithm should I select when creating a Coinbase API key?

Select the legacy SDK (software development kit) option, not the "Recommended" default. SabrTrader requires the legacy signature algorithm to sign its API requests. Choosing the recommended option will prevent the connection from working.

Do I have to re-enter my API key and secret each time I connect?

No, provided you click Save Profile after pasting them. Saving persists the credentials in the connection profile. On subsequent sessions you simply select the saved profile and click Connect no re-entry needed.

Where does Coinbase save my API key and secret file?

When you create the key, Coinbase downloads a text file containing both the API key and the API secret to your browser's default download location. This is the only time the secret is shown, so move the file to a secure, encrypted location or password manager immediately.

Which permissions must be enabled on the Coinbase API key?

All four permission checkboxes shown at key creation must be enabled. Leaving any one unchecked can cause the connection to fail or limit functionality. If you are unsure which are checked, delete the key and create a fresh one with all four enabled.

Can I connect other crypto exchanges the same way?

Yes. The general process is the same across most crypto exchanges: highlight the exchange in the Crypto category, Add it to create a profile, and paste an API key and API secret generated on the exchange. The subtle differences are per-exchange details such as Coinbase's requirement to use the legacy SDK signature algorithm.

What happens if I lose my API secret?

The API secret cannot be retrieved after creation it is displayed only once in the downloaded file. If you lose it, delete the existing key in Coinbase and create a new one, then re-enter the new key and secret in SabrTrader.

Do I need to close the default workspace before connecting?

It is not strictly required, but closing the default workspace keeps the Control Panel as the sole focus and avoids clutter while you work in the Connections manager. The default workspace contains only starter panels unrelated to the connection.

What is the dxFeed connection and should I disconnect it?

dxFeed is the delayed market-data feed SabrTrader connects to out of the box so new users see data immediately. It supplies prices only and cannot route orders. You can disconnect it when connecting Coinbase if you do not need it, but leaving it connected does not harm the Coinbase connection.

How do I open a Bitcoin chart after connecting?

Open the Chart creation dialog, choose the BTC/USD pair, set the timeframe to 15 minutes, set history depth to about 21 days, and click Create Chart. A live streaming 15-minute Bitcoin chart appears.

Is the Coinbase connection a data feed or a broker connection?

When created with trading permissions enabled, the Coinbase connection provides live market data for your available assets and account access. If you only enable data-related permissions it behaves as a market-data source. For this setup all four permissions are enabled.

Why are the connection fields locked when I highlight Coinbase?

The highlighted entry is a read-only preconfigured template. The API key and secret fields only become editable after you click Add, which creates the editable new Coinbase profile.

What does a successful connection look like?

After clicking Connect, SabrTrader connects automatically without an additional login prompt, and the connection status indicator in the Connections manager shows the profile as connected. You can then create charts on any Coinbase symbol.

Troubleshooting

Connection fails immediately after clicking Connect

The most likely cause is the wrong signature algorithm. Return to Coinbase, delete the key, and create a new one with the algorithm set to legacy SDK rather than Recommended. Re-enter the new key and secret and Save Profile before connecting again.

Connection succeeds but data or account access is limited

One or more of the four Coinbase API permissions was likely left unchecked. Recreate the key with all four permission checkboxes enabled, then re-enter the credentials in SabrTrader.

Authentication error referencing an invalid or unknown key

The key may have been deleted or has expired on Coinbase, or the key/secret was pasted incorrectly. Verify the key still exists in Coinbase's API page. If it was deleted, create a new key and update the SabrTrader profile.

Credentials must be re-entered every session

You did not click Save Profile after pasting the key and secret. Re-open the profile, paste the credentials, click Save Profile, then Connect. Thereafter you only need to click Connect.

'DX feed connection loss' message appears

This message relates to the out-of-the-box dxFeed delayed feed being disconnected, not to Coinbase. It is expected if you deliberately disconnected dxFeed and can be ignored for the Coinbase connection. Reconnect dxFeed from the Connections manager if you want its delayed data back.

Cannot type into the API key or secret fields

You are viewing the locked preconfigured template. Click Add to create the new Coinbase profile, which unlocks the API key and secret fields for editing.

Lost the credentials text file before entering it

The API secret is shown only once and cannot be recovered. Delete the existing key in Coinbase, create a new one (with all four permissions and legacy SDK), and save the new credentials file securely.

Glossary

API key
A public identifier used to authenticate SabrTrader with your Coinbase account and identify which account the requests belong to.
API secret
A private credential paired with the API key that authorizes data and trading access. It functions as a password and must never be shared.
BTC/USD pair
The trading pair quoting Bitcoin priced in US dollars.
Connections manager
The area of the Control Panel containing SabrTrader's 57 preconfigured broker and data-feed templates, saved profiles, and the Add, Save Profile, Connect and Disconnect controls plus the status indicator.
Control Panel
The primary SabrTrader window hosting platform-wide functions: the Connections manager, workspace management, and the launcher for new charts and panels.
Data feed connection
A live link between SabrTrader and an exchange or data provider that supplies market data for charts and order-flow tools.
dxFeed
The delayed market-data feed SabrTrader connects to out of the box so new users see data immediately. It provides prices only and cannot route orders.
History depth
The amount of past data loaded when a chart is created, expressed in days or bars. Greater depth provides more context but increases load time.
IP whitelist
An optional security setting that restricts API access to specified IP addresses. Left blank for a standard desktop setup.
Perpetual futures (perps)
Derivative contracts without an expiry date used to speculate on crypto price without owning the underlying asset.
Signature algorithm (SDK)
The cryptographic method Coinbase uses to sign API requests. SabrTrader requires the legacy SDK setting rather than Coinbase's Recommended default.
Spot market
A market where crypto assets are traded for immediate delivery at current prices, involving the actual purchase and sale of the underlying coins.
Timeframe / bar interval
The duration each candle or bar represents on a chart, such as 15 minutes. Smaller intervals reveal more detail with more noise; larger intervals smooth price.
Workspace
A saved SabrTrader layout containing charts, DOMs and panels bound to specific connections. Workspaces can be created, named, saved, closed, reopened and switched.