api key management

boekenbox edited this page Feb 11, 2019 · 5 revisions

Managing API keys

After the initial license registration, you can manage your own API keys and change them anytime. With GUNTHY token, license ownership is validated on the blockchain.

Warning:

You are responsible for your own API keys and GUNTHY wallet. Please understand that we might not be able to help you if you lose all your API keys and (access to) your wallet address. Make sure to follow all the security advise when setting up a wallet and properly save and backup the API key(s) used for Gunbot.


Contents:

  1. Registering API keys to a GUNTHY wallet address
  2. Updating API keys
  3. FAQ
  4. Steps to create a GUNTHY wallet

Registering API keys to a GUNTHY wallet address

After your reseller registered an API key to be used for Gunbot, you can take control and update it yourself. This is how it works:

Step 1: Reseller registers your API key to be used with Gunbot.

For each exchange you use Gunbot on, your reseller initially registers the API key on the Gunbot license server.

Step 2. Create a GUNTHY wallet.

GUNTHY is an ERC-20 token, this means that most Ethereum wallets are compatible.

Use this smart contract to add the GUNTHY token to your wallet: https://etherscan.io/address/0x3684b581db1f94b721ee0022624329feb16ab653

Contract address: 0x3684b581db1f94b721ee0022624329feb16ab653

If your wallet software asks about the number of decimals to use for GUNTHY, enter 18.

Read more about the steps to create a GUNTHY wallet.

Step 3a. Enter your exchange API key(s)

Enter your exchange key(s) on Settings > Trading > Exchanges.

In Gunbot, use your registered API key as master key. Optionally you can use a secondary API key for trading, this key needs to exist in the same exchange account as the registered API.

exchange-keys

Step 3b. Register your GUNTHY wallet address

Enter your GUNTHY wallet address on Settings > Prefences > Gunthy Wallet.

Enter your GUNTHY wallet address. All of your API keys are then registered to this wallet address.

When you add registered keys to Gunbot after already having set your wallet address, the new keys are automatically registered to this wallet.

image

Step 4. Receive GUNTHY airdrop

After you've connected an exchange, you'll receive an airdrop of 1000 GUNTHY per registered API key.

To use Gunbot, your wallet must hold 1000 GUNTHY for each exchange in use.

During the initial rollout of the new license system, airdrops are not yet automatic. Gunbot will work without a token balance until this process is fully tried and tested.


Updating API keys

To update your master key, you can simply choose a connected exchange and enter a new API key.

The key is then automatically licensed to be used in combination with your GUNTHY wallet. The new key can be used immediately and is entered as Masterkey in your exchange settings. In case you use the same key as trading key, make sure to update this in the settings for connected exchanges.

The API secret is only used to update your exchange settings.

image


Updating GUNTHY wallet

If you need to switch to another GUNTHY wallet, you can update it on Settings > Prefences > Gunthy Wallet.

All of your registered API keys connected to the old wallet address will be registered to the new wallet address after updating it.

image


FAQ

Are there costs involved when I update my API key?

No, when you manage your own API keys there are no costs for changing them.

How often can I update my API key?

You can update your API keys as often as you want.

Can I run multiple Gunbot instances using the same GUNTHY wallet?

Yes.

I have more than one registered API key for the same exchange, what to do?

If you have multiple registered API keys for the same exchange, each key needs to be registered to a different GUNTHY wallet. You must run multiple Gunbot instances to do so.

Can I change my API key to another exchange?

No. You can only change your API key to a new key from the same exchange.

Is it mandatory to register a GUNTHY wallet for my API keys?

This is a new system, it is currently voluntary to register a GUNTHY wallet and self manage your keys. Please be aware that this might change in the future as GUNTHY usage grows.

My license allows for more API keys than I already registered, will I miss out on the airdrop?

No. Airdrops are on a per key basis. Every time you use a new registered key in Gunbot and connect it to your GUNTHY wallet, you'll get tokens airdropped for this new key.

Can't I just use any wallet address?

Abuse will not be tolerated. Only use your own GUNTHY wallet address in Gunbot. Using your own wallet address is the only way to receive and control the required amount of tokens.


Steps to create a GUNTHY wallet

To create a GUNTHY wallet, you must add a custom token to an Ethereum wallet and enter this contract address: 0x3684b581db1f94b721ee0022624329feb16ab653.

Below you'll find short descriptions on how to do that with a few of the most used Ethereum wallet clients.

If you already have an Ethereum wallet, only the steps for adding a custom contract apply.

Ethereum Wallet

Step 1: create an account

Click Add Account and follow all the security advice given.

image

Step 2: add custom token

Go to Contracts and click Watch Token to add a new token.

image

Enter the GUNTHY token contract address and confirm.

image

Step 3: copy address

Copy the account address using the Copy address button. Use this address in Gunbot.

image


MyEtherWallet

Step 1: create a wallet

Create a new wallet and follow all the security advice given.

image

Step 2: add custom token

Unlock your wallet and go to Token balances and click Add Custom Token.

Enter the GUNTHY token contract address, as well as the token symbol (GUNTHY) and the number of decimals (18).

image

Step 3: copy address

Copy the account address shown on top of the page. Use this address in Gunbot.

image


Metamask

Step 1: install browser add-on and create a wallet

Follow the steps shown to be able to use Metamask. Create a new wallet and follow all the security advice given.

image

Step 2: add custom token

Click Add Token to add a new token.

image

Enter the GUNTHY token contract address and confirm.

image

Step 3: copy address

Copy the account address shown on top left side of the page. Use this address in Gunbot.

image


MyCrypto

Step 1: create a wallet

Follow the wizard and all the security advice given.

image

Create a new wallet and follow all the security advice given.

image

Step 2: add custom token

Go to View & Send and then to Token Balances to add a custom token.

Enter the GUNTHY token contract address and confirm.

image

Step 3: copy address

Copy the account address shown on top of the page. Use this address in Gunbot.

image

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.