# Coinbase Retail

{% hint style="info" %}
Connect your Coinbase Retail data to Integral using a read-only API key. Create your API key in Coinbase [here](https://www.coinbase.com/settings/api). Make sure all accounts are selected with only read permissions. Add your new Coinbase API keys to Integral [here](https://app.integraltreasury.xyz/accounts/add/coinbase).
{% endhint %}

***

### Step 1: Create a read-only API key in Coinbase

1. Log into your [Coinbase](https://www.coinbase.com/) account
2. In the top-right corner, navigate to Profile > Settings > API ([link to page](https://www.coinbase.com/settings/api))
3. Click on `Create API Key`

<figure><img src="https://3061199926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft1fkaxq4yvhcAFiQKv7R%2Fuploads%2Fq0xlpsi3p0uasvQAH3D6%2Fimage.png?alt=media&#x26;token=bbe270e1-99a2-4285-899d-412938573a4a" alt=""><figcaption><p>Create API Key</p></figcaption></figure>

{% hint style="warning" %}
Do not use **Advanced API.** This is for the Coinbase Developer platform and for executing trades and stop-limit orders.
{% endhint %}

***

### Step 2: Configure your API key permissions to read-only from all accounts

1. In the modal that appears, select the portfolio you want the API key to read
2. Select `View (read-only)`
3. Do not input any IPs to whitelist

<figure><img src="https://3061199926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft1fkaxq4yvhcAFiQKv7R%2Fuploads%2FQhrfO6WORjTx6fQAyGPJ%2Fimage.png?alt=media&#x26;token=b96ad690-4db3-47a1-b408-31f48c2229ef" alt=""><figcaption></figcaption></figure>

4. After you click `Create & download`, your API Key and Private Key will appear. *Save the downloaded file in a safe place!*

<figure><img src="https://3061199926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft1fkaxq4yvhcAFiQKv7R%2Fuploads%2FjWjKIoA5KJoOzvFmkSpW%2Fimage.png?alt=media&#x26;token=af57d34d-d5bd-4adb-ae74-6751aa1f16b8" alt=""><figcaption><p>Your API Key and Private Key</p></figcaption></figure>

***

### Step 3: Add your Coinbase account to Integral

1. Log into Integral
2. In the side panel, navigate to [Wallets](https://app.integraltreasury.xyz/wallets) > `+Wallet/Account`
3. Search for Coinbase, and make sure you select the option that says “Coinbase” **only** ([link](https://app.integraltreasury.xyz/accounts/add/coinbase))

<figure><img src="https://3061199926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft1fkaxq4yvhcAFiQKv7R%2Fuploads%2FviMhR7pn9fR7cZ09gyfb%2Fimage.png?alt=media&#x26;token=0e66a039-478a-4c2b-8b46-0469a151d687" alt=""><figcaption></figcaption></figure>

4. Paste in your API Key and API Private Key. Make sure to include everything **within the quotation marks**, or copy and paste using the Copy button in the screenshot in the previous step.
5. Click `Sync`
6. It may take a few minutes for all your transactions to load into Integral. You can see transactions trickle in from the [Bookkeeping](https://app.integraltreasury.xyz/accounting?category=for-review\&page=1) page.
7. Transactions are done loading when your Unrealized Gain/Loss and Transaction Count appear in the Treasury page.

***

### FAQ

1. **I can’t see my API Secret when creating a new API Key**

   *Clear your full cache and cookies in your browser. Exit your browser completely. Restart and try the process again. This should remedy it.*
2. **I added my key already, but now it says it's invalid**

   *Coinbase has* [*discontinued*](https://docs.cdp.coinbase.com/coinbase-app/docs/api-key-auth-legacy) *their Legacy API Keys, and in response Integral has added a feature for you to update your connection with your new API key. Follow the same steps above to generate a key, and edit as shown below:*

<figure><img src="https://3061199926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft1fkaxq4yvhcAFiQKv7R%2Fuploads%2FYhwc7RbkCCw8jnowEd3x%2Ffinalfinal.gif?alt=media&#x26;token=bed4dd8d-4d0c-45d8-b232-974446469821" alt=""><figcaption></figcaption></figure>

1. **I added my API keys into Integral, but nothing is showing up**

   There are a few reasons this might happen:

   *1) Your account may be taking longer than expected to process. Typically you should see some transactions after a couple minutes.*

   *2) If after a few minutes no transactions appear, make sure you are using the right integration. From the Wallets page, make sure Coinbase was selected (not Coinbase Prime / Pro / Custody / or Commerce). Also make sure you are using the right Coinbase platform, it should be the one accessed from the url:* [*https://www.coinbase.com/*](https://www.coinbase.com/)

   *3) If you are logging in through a different URL, refer back to Coinbase Ecosystem.*<br>

If you are still experiencing issues, contact Integral at <help@integral.xyz> or reach out to your rep.