## API Keys

This document guides you through the process of getting access to the Bitcoin Suisse API.

Already have an `API Key` but don't know how to use it? Have a look at the [REST Authentication](/api/pages/rest/authentication) guide.

### 1. Activate API usage for your account

To get access to the Bitcoin Suisse API, existing customers can request API access via their Relationship Manager.
Contact your Relationship Manager and request API access.

- You can request multiple API Keys.
- An API Key can have different access rights:
  - `Read Only`: Can read information.
  - `Deposit & Withdrawal`: Can read information and create deposits and withdrawals, not allowed to place orders.
  - `Trading`: Can read information and place orders, not allowed to deposit/withdraw funds.
  - `Full Access`: Full access to all API functionality.
- Institutional clients with access to multiple customers can create API Keys for specific sub-sets of the customers they manage.


### 2. Create an API Key

After API access is granted, a new API Key can be created in Bitcoin Suisse Online.
To do this, navigate to `Settings > API Keys`.

Note: You will not see this menu if you don't have API access.

![](/assets/api-key-online-create.e7a7b356b8a9afad612204c5cd65036d2b228c3bf38f579ddbe3cca9f579ec03.def75362.png)

To create your Bitcoin Suisse API Key, click on `Create New` and read and confirm the disclaimer.
Now you are presented with your `API Key` and the corresponding `Secret`.

Important
Store this information in a secure place. You won't be able to see it again
after you close the pop-up.

![](/assets/api-key-online-created-secrets.dc2f35b496c476f8bf3efa256af43ad3e8d442763ab4d8edcfc7059cee4623ad.def75362.png)

### 3. Expiration, renewal and revocation

Your `API Key` is valid for a limited amount of time. After this, a new `API Key` has to be generated.
If an `API Key` expires, you can press the `Delete` button. After that, you can create a new key as described in [chapter 2](#2-create-an-api-key).

![](/assets/api-key-online-expired.04af92d0351c226dca6a8a7484273ccb5419abae1cc792aa2a806a40bd20af24.def75362.png)

You can also delete your `API Key` any time you wish, for example when it's no longer used or you lost your `API Key`/`Secret`.

![](/assets/api-key-online-created.a5a69d13b67cc4b851dfd2a080e50e7cc3e14eac2521ca45e15c5c119705dc14.def75362.png)

If you want to change the permissions of your `API Key`, please contact your Relationship Manager to configure this for you. See [chapter 1](#1-activate-api-usage-for-your-account) for details.