# How to create and setup HitBtc API key

In this article, we will show you how to create, configure, and connect your HitBtc API key to the Darkbot platform.\
\
**DarkBot** is a trading platform that allows you to work with numerous cryptocurrency exchanges from a unified interface with access to additional tools that are not available on the exchange.

All trading operations are created and processed by using an exchange API key which is unique for every user. An **API key** is a safest and reliable way to use a platform because it does not give access to your personal data and prevents any funds management (withdrawals & deposits).

#### 1. Log in to [HitBtc](https://hitbtc.com)

Log in to your HitBtc account or create a new one.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FUO1wUjZKXyLUcUmOby7J%2Fimage.png?alt=media&#x26;token=c7e21fd0-949f-47e7-a98c-dd3cbd81a81c" alt="sign in button"><figcaption><p>Sign In button ot the Hitbtc.com</p></figcaption></figure>

#### 2. Go to the Settings page and select Api Key tab

From main page navigate to **Settings** (top-right corner).

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2F99zTdIWtkXmlIqE4YUjk%2Fimage.png?alt=media&#x26;token=fc6edf78-39f8-4bac-8211-9dfbc3023378" alt="Settings button"><figcaption><p>How to go to the Settings page</p></figcaption></figure>

And now it is necessary to select the **API keys** tab.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FHTTdgcLDpvberueBB4RU%2Fimage.png?alt=media&#x26;token=948eef1a-5b6f-40bb-a019-715be26051af" alt="API keys tab"><figcaption><p>How to select Api keys tab</p></figcaption></figure>

#### 3. Create new API key

To create a new API key, click on \[**New API key]** button (on the right side).&#x20;

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FU0pTwDHudknP8iPTAQIB%2Fimage.png?alt=media&#x26;token=7e7009e5-5cba-49a2-a9af-bd7ca6d15442" alt="New API key button"><figcaption><p>New API key button</p></figcaption></figure>

#### 4. Copy your API key and Secret key

Do not forget to save your API and secret keys. Otherwise, when you close the window, the keys will become hidden and you will have to start all over again.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FXoVSXtgMh2iOB96Xmc7T%2Fimage.png?alt=media&#x26;token=5fbae57d-3ed9-4f80-b4d5-1c1a20a42ac3" alt="API and Secret keys"><figcaption><p>API and Secret keys</p></figcaption></figure>

#### 5. Click on \[I Understand] button

After saving the keys, click the **\[I Understand]** button

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2F4voIwcRI8zNhVrsn252C%2Fimage.png?alt=media&#x26;token=96e7d7e3-19c3-4323-9419-6254513d118a" alt="I understand button"><figcaption><p>I Understand button</p></figcaption></figure>

#### 6. Label your API key.

Give your API key **any name** (it is your personal choice) so you can easily understand that this key is connected to your Darkbot account.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FQy7K74hHxnFhkt3PZssr%2Fimage.png?alt=media&#x26;token=7553fb58-e551-46dd-b800-45a557ed2712" alt="Name input"><figcaption><p>Label your Api Key</p></figcaption></figure>

#### 7. Match API key access rights.

Now you need to Edit acess rights on your API key so our platform receives access to process your trading activity on your HitBtc account.

#### &#x20;Here the list of required permissions:

1. Order book, History, Trading balance **on**
2. Place/cancel orders **on**
3. Payment information

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FDiRxYhrEthX5tsdzIwv4%2Fimage.png?alt=media&#x26;token=935f5591-4615-4887-8e5f-6f654e67a01d" alt="Acess Rights"><figcaption><p>Acess rights</p></figcaption></figure>

#### 8. Add an Darkbot IP to the whitelist

Now it is necessary to add IP addresses. To do this, click on the Edit button.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FYVRlOkBH1VXiFkUDYR2i%2Fimage.png?alt=media&#x26;token=664932ea-888d-4be5-a93f-b1419f65d2a2" alt="Edit button"><figcaption><p>Edit IPs button</p></figcaption></figure>

In the window that opens. In the New IP field, enter the provided IPs separated by commas. Then click the \[Add] button:

List of IPs:

`54.163.23.236, 3.82.203.161, 54.89.220.170, 34.232.48.137, 52.59.223.126`

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2Fpx3ZlbqwDNkirfRo0iqH%2Fimage.png?alt=media&#x26;token=8078c6cc-2c5e-4757-ac9c-bc7436fb278f" alt="IP input and Add button"><figcaption><p>IP input and Add button</p></figcaption></figure>

When ready click **\[Save]** button.

#### 9. Submit creating Api Key

Now you need to confirm the key creation by entering the authentication code. Enter the code in the input and click the **\[Confirm]** button.

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2F7ZNoBeXsCXxIUwH7NnHi%2Fimage.png?alt=media&#x26;token=f2e0fbff-f12b-4922-a75a-ea76b1d31e95" alt="Authentication code"><figcaption><p>Authentication code</p></figcaption></figure>

After you need to confirm the creation of Api key by clicking on the link sent to your Email:

<figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FybsCIwQ1sIDavhthC7nE%2Fimage.png?alt=media&#x26;token=cc3e3150-2b2d-4432-8762-39ad15b8d6d7" alt="Email confirmation"><figcaption><p>Email confirmation</p></figcaption></figure>

**10. Match you API key with our application**

1. Login to your **Darkbot** account. (<https://app.darkbot.io/login>)
2. Navigate to the **Credentials** page<br>

   <figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2FDO4zT0TqhWsyI9z031F3%2Fimage.png?alt=media&#x26;token=a253f9e2-0c43-424e-9a6a-76055fba287f" alt="Dashboard page"><figcaption><p>Dashboard page</p></figcaption></figure>
3. Click **\[Connect exchange]**<br>

   <figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2F35p9lDKpAD9s0hwUXBc3%2Fimage.png?alt=media&#x26;token=63384e05-68af-4117-8a44-4a3a8d41a67e" alt="Credentials page"><figcaption><p>Credentials page</p></figcaption></figure>
4. Select **HitBtc** exchange in the dropdown and enter **API** and **Secret** keys<br>

   <figure><img src="https://4293125416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjGlKIexsDCCDKIAN_z%2Fuploads%2Fo6ptbEts9ooC6ypUrDNl%2Fimage.png?alt=media&#x26;token=0cdb7970-05f8-4448-8c23-75c4e3059565" alt="Create credential pop up"><figcaption><p>Create credential pop up</p></figcaption></figure>
5. Click **\[Save]**