Poloniex

A comprehensive guide on how to generate your API keys on Poloniex!

Note: This guide will walk through how to create an API Key for both Main accounts and Futures accounts; please note that Poloniex separates these into two accounts, therefore you will need to create one API key for Margin/Spot and one API key for Futures. This guide will proceed with creating a Main Account API, with a walkthrough at the end on creating a Futures Account API.

Step One: Log in to your Poloniex account at https://poloniex.com/login

Step Two: After signing in, select your profile icon in the top right corner, then select Profile from the dropdown.

Step Three: Select the “API Keys” button, then click "Create New Key".

Specific to Poloniex, you will need to choose whether you are creating an API for your Main account, or an API for your Futures account. The process will be slightly different for both, but please ensure you have selected the correct account - be aware that if you are trading both Spot/Margin and Futures, you will need to run two separate APIs to capture complete data. This guide continues with a Main Account API, but has included a Futures API guide at the end.

Step Four: Enter your 2FA code and check your email to verify API creation (within 15 minutes)

Step Five: Record your API keys and UPDATE permissions!

This next screen will display your API keys - be sure to record your Secret Key in a secure location, although currently on Poloniex this key can be unhidden even after the page is refreshed.

IMPORTANT: You need to UN-CHECK "Enable Trading" from the Options section - Poloniex defaults all new API keys to have trading enabled, and the Hash Data tool will deny the API key if any trading functions are enabled, so be absolutely sure you DISABLE TRADING before you proceed.

Step Six: Enter your API keys into the Hash Data tool

Log into the Client Portal of the Hash Data tool, then navigate down to Exchange Accounts (1), selected Add Exchange (2), then enter your keys where prompted (3). As reference, the "API Key" from Poloniex is the "" in the Hash Data tool.

Step Seven: Click "Test Keys" and let that complete.

If the test sends an error in response, please re-review the information entered and the permissions associated with the API key. The software has a number of checks in place to prevent users from uploading keys with "Edit" capabilities, so this is the most common source of errors.

Once the keys are tested and no errors are noted, click "Submit".

Follow the previous guide until Step Three, then click "Futures API Keys"

Step Four: Enter your API key parameter information

You will be prompted to create a new API Key. In "API Name", enter a label for your key. In our example we chose to make it “How To Guide”. We recommend making the label as descriptive as possible to reflect the use case of the specific API.

Poloniex also requires you to enter an API Passphrase for Futures accounts - do NOT enter a passphrase you have used anywhere else, as you will need to enter this into the Hash Data tool later. Once completed, hit "Create" and enter your 2FA codes when prompted.

Step Five: Record your API keys and verify permissions once more

This next screen will display your API keys - Unlike the Poloniex Main Account API, the Secret Key for your Futures Account API will be permanently hidden once the page is refreshed, so be sure to record your Secret Key in a secure location.

Also take this time to conduct your final check to ensure that the "API Restrictions" only states "General" - Unlike the Poloniex Main Account API, the Futures API permissions default to Read-Only which is what you are looking for, so be sure that "Trade" is not selected and "IP Limit" is set to "No Limit".

From here, follow the previous guide from Step Six onwards (with the only difference being that you will select "Poloniex Futures" from the Exchange list, and need to insert your Passphrase)

Congratulation - the Hash Data tool is now able to read your exchange account!

If you are looking for information on how to process information from your exchange account and begin running reports from this balance, please proceed to the User Guide!

For any questions, please reach out to [e-mail] for additional assistance.