2024.12.5
Home ▸ Integrations ▸

Coinbase

The coinbase integration lets you access account balances and exchange rates from Coinbase.

You will need to obtain an API key from the API section in Coinbase’s User Settings to use this integration. Your API key and secret should be of the form organizations/XXXXX/apiKeys/XXXXX and -----BEGIN EC PRIVATE KEY-----\nXXXXXXXXXXXXXXXXX\n-----END EC PRIVATE KEY-----\n respectively. When creating your API key, it is highly recommended to ensure that only the View box is ticked in the API restrictions section.

Configuration

To add the Coinbase integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Coinbase.

  • Follow the instructions on screen to complete the setup.

API Key

Your API key generated by Coinbase, this is required.

API Secret

Your API secret generated by Coinbase, this is required.

Options

Options for Coinbase can be set via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • Go to Settings > Devices & Services.
  • If multiple instances of Coinbase are configured, choose the instance you want to configure.
  • Select the integration, then select Configure.
Wallet balances to report

List of currency codes to create account wallet sensors for.

Exchange rates to report

Optional list of currencies to create exchange rate sensors for.

Base currency for exchange rate sensors

Currency used as the currency unit for exchange rate sensors. The default is US Dollar (USD).

Number of decimal places for exchange rates

The number of decimals calculated in exchange rate sensors, a smaller number of decimal places may be returned when the upstream data from Coinbase lacks sufficient precision, this is usually the case when the exchange rate is much larger than the base currency and thus should have no significant effect on calculations.