In brief: To set up a new exchange, find it in the Untested crypto exchanges node and bring it to a less crowded crypto exchanges node to make room for the new setup. Then add the assets and the markets you wish to work with, and finally, install the markets.

A list of tested exchanges is available here.

Click to learn about the list of tested exchanges

The system implements the CCXT library which allows connecting to a vast list of exchanges. However, many exchanges do not fully comply with the standards established by the library.

The following is the current state of tests on different exchanges:

Exchange OHLCVs Capability [*] Market History Trading Capability [**] Comments
Binance Starting Sep, 2017 Fully tested. Starting with Binance is recommended as the experience is seamless.
Bitfinex 1 year Tested, with issues: we have experienced the ERR_RATE_LIMIT error despite the fact that Superalgos sends a maximum of two requests per market / bot / minute when trading live.
Bitmex   The concept of a contract is not yet implemented within Superalgos, thus, trading is not enabled yet.
Kraken Historical data may only be accessed by id, not by date, thus not available at the moment.  
Poloniex Only 5-minutes time frame available in OHLCV data, while 1-minute is required, thus not available at the moment.  
Bittrex A few weeks, depending on the market. Live trading not available because Bittrex allows limit orders only (Superalgos may only place market orders at the moment).
Gemini A few hours.  
HitBTC    

[*] The ability to fetch historic data for backtesting purposes has been verified.

[**] The ability to run strategies in live-trading mode has been verified.

You are free to test exchanges that haven’t been tested by the team. That said, it is highly recommended to start with tried and tested exchanges until you become proficient with using the system before venturing into the unknown landscape of untested exchanges.

Not all tested exchanges are set up in the default workspace. If you wish to use an exchange that is not set up in the workspace, you may set it up yourself following the instructions below.

Start here

1. Expand the Untested crypto exchanges node in the crypto ecosystem hierarchy.

2. Locate the desired crypto exchange, detach it from its parent, and attach it to the Testing Queue crypto exchanges node. You may choose to attach your select exchange node to any other crypto exchanges node, or even add a new one. This is merely for organizational purposes and to keep the workspace tidy.

Click to learn about attaching and detaching nodes

Attaching and Detaching Nodes

Nodes in the workspace may be unchained or detached from its parent, carrying all offspring with it. When a node is left unchained, it is no longer taken into account in the logic of the hierarchy, as it no longer belongs to it. When a node is chained back or reattached to the hierarchy, it goes back to being functional.

This feature is useful when testing different configurations, rules or parameters, as it allows to keep alternatives handy in the workspace.

To detach a node, right-click on it and drag it away from the parent node. To attach a node, right-click on it and move it closer to the node you wish to attach it to.

You may also use the detach option on the menu to break a relationship.

Nodes may be attached only to potential parents. The system limits the way in which nodes may be attached, according to the logic of the information they contain.

3. Find the exchange assets node and add the assets you wish to work with.

Click to learn more about assets

Adding an Asset Node

To add an asset, select Add Asset on the exchange assets node menu.

To add assets in bulk, select Add Missing Assets on the exchange assets node menu. Beware that the exchange may handle hundreds of assets. Before using this option you may want to implement a filter using the exchange assets configuration.

Click to learn more about exchange assets

Configuring the Exchange Assets Node

Select Configure Exchange Assets on the menu to access the configuration.

{ 
"addMissingAssets": { "quotedAsset": "BTC"} 
}
  • addMissingAssets acts as a filter to determine which assets of a (potentially long) list of assets listed at the exchange will be added when the Add Missing Assets option in the menu is used. Because many exchanges do not offer a list of assets, the system fetches assets from actual markets (pairs) listed at the exchange. You may add missing assets filtered by the quotedAsset or by the baseAsset. For example, the above configuration would add all assets listed in markets in which BTC is the quoted asset.
Configuring an Asset Node

Select Configure Asset on the menu to access the configuration.

{ 
"codeName": "BTC"
}
  • codeName is the ticker of the asset as listed by the exchange (i.e.: BTC, BTH, ETH, LTC, BNB, USDT, USD, etc.)

4. Go to the user assets node under exchange accountsuser account.

5. Add one exchange account asset per each asset added on step 3. You will need these to run trading sessions later on.

Click to learn more about exchange account assets

Adding an Exchange Account Asset Node

To add an exchange account asset node, select Add Asset on the user assets node menu.

6. Establish a reference from each of the exchange account assets under exchange accounts → user accounts to each asset under the exchange assets node.

Click to learn more about references

no## Visibility

To switch on and off the visibility of references across the design space, use the following hot-key combination: Ctrl or ⌘ + Shift + R.

no## Direction

References have a direction property relative to each of the nodes involved in the reference: the node establishing the reference sets an outgoing reference, while the one accepting the reference sets an incoming reference.

For example, a session establishes an outgoing reference with a trading system. This allows the session to access the information within the whole trading system hierarchy, including strategies. At the trading system level, the same reference is viewed as an incoming reference.

Sessions-03-Link-Session

no## Scope

A reference established between nodes of any particular structure within a hierarchy is said to be an internal reference relative to the said structure of nodes. Similarly, a reference established with a node outside of the said structure, that is, in a different part of the hierarchy or in another hierarchy, is said to be an external reference.

Examples of internal references may be found in the data mine and crypto ecosystem hierarchies. For example, let’s briefly look into one such case within a plotter module:

The capture below shows the shapes node and several offspring nodes: on one hand, several polygons; on the other hand, the chart points node.

Backups-04-Internal-references-intro-shapes

Notice that vertices under each polygon reference to points under the chart points node.

This means that the node shapes feature several internal references.

Click to learn how to remove and establish references

In brief: To remove a reference, click on the remove reference button on the node's menu. To establish a reference, right-click on the node where the reference should originate and drag it close to the target node. Releas the right-click to establishes the reference.

Use the delink option on the menu to remove a reference.

In case multiple nodes would accept the reference, the one closer to the node where the reference originates will have its ring highlighted.

Once established, the reference is visually represented by a faint grey dotted line. Such line is visible only when both ends of the reference are visible and when hovering the mouse over the node.

7. Go to the exchange markets node and add the markets you wish to work with.

Click to learn more about markets

Adding a Market Node

To add a market, select Add Market on the exchange markets node menu. The market node is created along with the basic structure of nodes used to define the market. This option does not generate the super actions required to install and uninstall markets.

To add markets in bulk, select Add Missing Markets on the exchange markets node menu. This option adds all markets listed at the exchange that may result from the combination of assets listed under the exchange assets node, along with the required super actions to intall those markets.

8. The final step is installing the desired markets.

Click to learn how to install a new market

In brief: To install a new market, click Run on the install market super action corresponding to the market you wish to install. If the market is not set up, then you must set it up first.

If the market is set up in your preferred exchange, click Run on the corresponding install market super action node menu.

1. Expand the exchange markets node of your preferred crypto exchange in the crypto ecosystem hierarchy.

Click to learn how to find a hierarchys

In brief: To find a hierarchy, access the design space map with a right-click of the mouse, and left-click on your desired destination.

The image illustrates points 1 and 2 below.

1. Access the design space map.

Right click anywhere on the design space to access the design space map.

2. Left-click on your desired destination.

That should take you to the exact point you clicked on the map.

For your information, the design space is organized over a square perimeter around the workspace node, and each hierarchy is located on one of the cardinal directions. Hierarchies feature an ever-present white ring. The ring hints the direction in which a hierarchy is located.

Hierarchy Cardinal Direction Direction Keyboard Shortcut (Windows only)
Sparta Data Mine North Ctrl + Alt + S (S for Sparta)
BRR trading System North East Ctrl + Alt + W (W for Weak Hands Buster)
WHB Trading System East Ctrl + Alt + B (B for Bull Run Rider)
Super Scripts South East Ctrl + Alt + Z (Z for, well…)
Network South Ctrl + Alt + N (N for Network)
Crypto Ecosystem South West Ctrl + Alt + E (E for Ecosystem)
Charting System West Ctrl + Alt + C (C for Charting System)
Masters Data Mine North West Ctrl + Alt + M (M for Masters)

2. Click Run on the Install Market super action node menu corresponding to the market you wish to install.

Running the super action deploys all the infrastructure required to start using the new market, including the following:

  1. Data storage structures of nodes.

  2. Data mining operation for the corresponding exchange and market.

  3. Testing environment and production environment task managers featuring tasks for all types of trading sessions referencing the Weak-hands Buster trading system. You may change the reference for any other trading system you may be using.

  4. A time machine containing a timeline chart for the market, made readily available on the charting space.