Skip to content

NescienceSoftware/Nescience-Indexing-GUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Image

Software Solutions for Alpha Seeking Portfolio Management



Table of Contents


Description

With our open-source portfolio management tool, an investor with no previous experience can apply a variety of automated portfolio rebalancing strategies to their portfolio. Further, due to our entirely client side application, we are able to ensure transaction security and offer the most secure portfolio management tool available at no upfront cost to our users.

A demo of our tool can be found 24/7 on our twitch channel: NescienceSoftware

Media


Setup

Compatable with Windows 64-bit

Installation

Installation in the form of an executable is relatively straightforward. Download the most recent release, unzip the file, and run "Nescience.exe".

API Configuration

To properly set up the tool the first step is to create an API key and enable proper key authorizations.

This process is different on each exchange, with each exchange having unique restrictions, for exchange-specific instructions pick an exchange from the list below:

NOTE: For legal reasons we do not provide the same level of support to those utilizing traditional market clearinghouses/brokers, use of our product does not constitute liability.

Operation

  1. Start up "Nescience.exe" in the folder "Nescience_Rebalance

Note: If a message questions the origin of the exe, do not worry, we will be getting a proper microsoft liscence ASAP.

  1. Select the exchange you intend to use.

  2. Chose to create a new configuration, load a configuration from file, or load the most recently used configuration for your exchange.

  3. Enter the asset you intend to trade against in the stablecoin entry field (i.e. BTC, USDT, EUR, etc.,)

  4. Open the asset selection screen and enter your assets based on their Symbol. (e.g. Bitcoin: BTC, Tether: USDT, etc.,)

Or load an asset selection (i.e. a previously saved selection, the provided S&P Index, etc.,)

  1. Enter your API Key and API Secret (and API Password if applicable).

  2. Select either Periodic Rebalancing or Threshold Rebalancing.

  3. Depending on your selection, determine your algorithm's threshold (e.g. 15% = 15) or your algorithm's period.

  4. Select "Save" to save your configuration for future use, or "Save & Run" to run your algorithm.


Further Operation

The application can be stopped with by either a keyboard command (Ctrl-C) or by exiting the application. (Command provides the safest shutdown)

The tool can be run in multiple instances under the same executable, provided there is only one instance per exchange.

Should there be a need for multiple instances on the same exchange, there need to be unique installations of the AI/tool.

IMPORTANT

When adding money to a portfolio that has already been configured, ensure that you reset the performance data using the "Reset Data" button.

If you do not, the built in profit tracking will not be able to detect the new deposit, resulting in poor graphical representation. Resetting ensures that a new baseline is established.

Any issues or inquiries can be directed to [email protected]

Back To The Top


API Setup

Binance

API Instructions
  1. Go to your Dashboard

  2. Click Settings

  3. Go to Api Management

  4. Name your API Key, click create, and enter your 2-factor-authentication key.

  5. Approve the API creation in your email.

  6. Edit the restrictions on the next page that pops up.

  7. Enable IP whitelisting, google "My IP address", and copy paste your IP address into the whitelist. This will ensure that only your IP address will be able to use the API key.

  8. Save your Key/Secret somewhere safe.

Back To The Top


Bitfinex

API Instructions
  1. Nagivate to your Account page.

  2. Navigate to "</> API".

  3. Click "Create New Key".

  4. Ensure all account privileges are enabled, importantly read/write capabilities for orders, wallets.

  5. Name your API Key, click generate and confirm API Key creation using the link sent to your email.

  6. When navigated to your API Key page, save your API Key and API Secret somewhere safe.

Back To The Top


Bittrex

API Instructions
  1. Go to your Account Page

  2. Under "Site Settings" click "Api Keys"

  3. Click "New Key"

  4. Ensure all account privileges are enabled, read & trade.

  5. Click save and enter your 2-factor-authentication key.

  6. Save your key/secret somewhere safe.

Back To The Top


Coinbase.Pro

This configuration works with coinbase.pro (GDAX) and coinbase.prime.

API Instructions
  1. Go to your profile.

  2. Go to "API Settings".

  3. Click "New API Key" in the upper right.

  4. Ensure all account privileges are enabled, view, trade, and transfer enabled.

  5. Create and save your API "password".

  6. Google "My IP address" and copy/paste your IP address into the whitelist. This will ensure your API key can only be accessed from your IP.

  7. Click save and enter your 2-factor-authentication key.

  8. You API secret will then pop up with your API key on the main API page, save your secret/key/password somewhere safe.

Back To The Top


Gemini

API Instructions
  1. Click on "My Account" in the upper right.

  2. Under My account, click on "API Settings".

  3. Under a primary account, click "Create a New Api Key"

  4. Enter your 2-factor-authentication key.

  5. Ensure proper account privileges are enabled, fund management and trading.

  6. Save your secret/key somewhere safe.

Back To The Top


Huobi

API Instructions
  1. In the upper right corner, while hovering over your profile and click "API Management".

  2. On the left side click "API Management".

  3. Name the key in "notes" and enable all API privileges, read, withdraw, and trade.

  4. Google "My IP Address" and copy/paste your IP address into the IP bind field. This will ensure your API Key can only be accessed using your IP address.

  5. Click "Create" to create your API Key.

  6. Click "Send Code" and enter the code sent to your email, in addition to your 2-factor-authentication key.

  7. Save your API Key and Api Secret somewhere safe.

Back To The Top


Kraken

API Instructions
  1. In the upper right corner, hover over your account name and click "Settings".

  2. Under settings, click "API".

  3. Click "Generate New Key".

  4. Name your API Key and enable all privileges for funds control and trading. (Including withdrawals)

  5. Save your API Key and Api Secret somewhere safe.

Back To The Top


Kucoin

API Instructions
  1. Go to your user profile.

  2. On the left side click "API Management".

  3. Click "Create API".

  4. Chose and save your API name and API password.

  5. Enter your trading password (Note that this is not your login or API password, but the 6 digit password required to make trades).

  6. Click "Send Code" and enter the code sent to your email, in addition to your 2-factor-authentication key below.

  7. Once the API key has been created, click "Change" right above the API Key.

  8. Ensure proper account privileges are enabled, general, trade, and transfer.

  9. Google "My IP address", enable IP whitelisting, and copy paste your IP address into the whitelist. This will ensure your API key can only be accessed using your IP address.

Back To The Top


Liquid

API Instructions
  1. Go to your user profile.

  2. Under your profile, navigate to "API Tokens".

  3. Under IP Whitelist, click "Add IP Address"

  4. Copy/paste your IP address into the field (Google "My IP address"), and select "All API Tokens". This will ensure your API key can only be accessed using your IP address.

  5. Enter your 2-factor-authentication key.

  6. Back on your API Tokens page, click "Create API Token".

  7. Ensure all account privilege are enabled, both read and write.

  8. Enter your 2-factor-authentication key and click "Create Token"

  9. Save your API Key (ID), and API Secret in a safe place.


Luno

Due to jurisdiction restrictions we are currently unable to provide specific instructions for API creation on this exchange.

Back To The Top


OkEx

Due to jurisdiction restrictions we are currently unable to provide specific instructions for API creation on this exchange.

Back To The Top


Poloniex

API Instructions
  1. In the upper right corner, hover over the wrench and click "API Keys".

  2. If you have not already enabled API access, click "Enable" and confirm using your 2fa and/or the link sent to your email.

  3. Next, once back on the "API Keys" page, click "Create New Key" and again confirm using your 2fa and/or the link sent to your email.

  4. Save your API Key and Api Secret somewhere safe.

  5. For added safety, you will want to enable IP Restrictions. This will ensure your API key can only be accessed using your IP address.

  6. Use the drop down and enable IP Restriction, confirming using your 2fa and/or the link sent to your email.

  7. Copy paste the IP address provided into the field and click save, again confirming using your 2fa and/or the link sent to your email.

Back To The Top


Upbit

Due to jurisdiction restrictions we are currently unable to provide specific instructions for API creation on this exchange.

Back To The Top


Ally

Ally Invest offers a wide range of self-directed and managed investment products at among the industry's lowest fees. They are a fully SEC registered broker and offer retirement accounts.

Ally has a unique API key schema, requiring 2 different API Key/Secret pairs.

API Instructions
  1. Log in to your Ally invest portfolio.

  2. In the bar at the top, click "Tools"

  3. Select "API".

  4. Once navigating to the API page, click, "Create a new application"

  5. Select personal application and enter your information, with the application name being "Nescience Indexing Tool".

  6. Click "Create".

  7. Back on your API page, click the Nescience Indexing Tool under "Developer Applications"

  8. Copy all four API Keys/Secrets and save them in a safe place.

Back To The Top


Alpaca

The Alpaca exchange is a clearinghouse for traditional equities that primarily supports algorithmic trading.

If interested, https://docs.alpaca.markets/

Remember to save your API Key and API Secret somewhere safe!

Back To The Top


Robinhood

Unlike other exchanges, robinhood uses a username/password rather than API keys/secrets.


Build

To ensure that the most recent release is genuine, check that the PGP-signature in "Signature.txt.gpg" is that of Nescience Software & Capital. Our fingerprint will always be available on our website's home page.

Further, the best way to validate a new release is to build/compile the CLI application yourself based on the Python scripts provided in the "Scripts" folder of our CLI github repo, while inspecting any new changes. This requires Python 3.5+ and a number of dependencies, and can be done following the steps below:

  1. If you do not already have Python 3.5+ install an appropriate version as can be found here. (https://www.python.org/downloads/)

  2. Open a command prompt and using these commands, download and install pip (pythons package installation tool).

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

python get-pip.py
  1. Ensure each dependency listed in "Dependencies.txt" are installed using pip.
pip install 'package==version"
  1. For each exchange you would like to use, in your "Scripts" folder copy and paste the given exchange folder from the Nescience Folder. (Coinbase= "GDAX", Binance = "Binance", Kucoin= "Kucoin", Kraken= "Kraken", etc.)

At this point, the scripts will function if called using Python, run "Nescience_rebalance.py" and chose your exchange!

Back To The Top


Nescience Software & Capital, LLC

Nescience Software & Capital is a portfolio management firm focused on advanced cryptocurrency portfolio management tools, facilitating investment with significantly reduced risk and more consistent long-term growth.

Back To The Top