TWM Wiki
Connections
Setting up a Connection
Please see video for an online example.
In order to download market data and/or trade user needs to configure a connection. Please proceed to Admin Panel -> Connections -> Configure to set up a new connection.
Existing connections will appear in the drop down menu demonstrated in the picture above after they have been set up. To set up a connection proceed with choosing the configure option.
TWM is a multi connection platform and users can have numerous connections running simultaneously allowing data and trading from several exchanges. In order to connect to an existing connection use the toggle to the right hand side of the connection name right inside the menu.
After you are successfully connected to a provider a connection name will appear in the TWM admin panel bottom toolbar and a success message wıll print in the log tab of the admin panel.
The connection configuration window will have available connections listed at the top. Each connection can only be added once by double clicking on it or by pressing the plus button which will move the connection from the top list to the bottom list to be available for further configuration. Please see individual connection instructions for further information on particular connection configuration requirements.
Binance
Binance connection requires API keys and secret only for placing orders and reading account information. If you only want to get market data you do not need a Binance account. Just set up a connection without any keys.
On the other hand, if you do wish to trade you will need a BInance account. In order to set up an API key you will need to log into your Binance account and go to https://www.binance.com/en/my/settings/api-management which is located under Account -> Api Management.
Copy the API key and secret from Binance API page to TWM connection set up parameters. Make sure you have provided the correct permissions for the API key. The minimum required permissions to trade spot and derivatives markets are enable sopt & margin trading and enable futures for trading futures.
It is highly recomended to restrict access to your trusted IP. You can see what IP you are using here https://whatismyipaddress.com/. Make sure you are not using dynamic IP that can change a few times even during a single day.
If you have set up a conection and after sometime you are not able to log in for some reason, please go to the above mentioned address and re-identify your IP to check whether it has changed or not. If it has changed, it means you have a dynamic IP and you might need to update it within the exchange restrictions regularly.
Please note that some old Binance accounts that have been set up prior futures have been introduced into Binance might by default require users to set up an IP filter in order to trade futures.
Bybit
For market data API key and secret is not required however for placing orders and reading account information API key and secret is compulsory. If you only want to get market data you do not need a Bybit account. Just set up a connection without any keys.
In order to set up an API key you will need to log into your account and go to https://www.bybit.com/app/user/api-management which is located under Account -> API. Please make sure your Bybit account is configured to use Unified Trading Account!!!. Bybit classic account is not supported.
If your Bybit account is not UTA (Unified Trading Account), you will usually see Spot and Derivates separately listed in your Dashboard. After you upgrade they will be merged to a single UTA (Unified Trading Account). On information about how to upgrade to UTA please contact Bybit support. Usually it is a very simple process and takes 2 minutes after you click a respective pop up button Upgrade to UTA somewhere on Bybit interface.
Make sure you have set up appropriate permissions for spot and/or futures trading as shown in the illustration above. Also make sure you have selected Read and Write permissions as shown above as we need to post orders to the exchange in order to trade from within the TWM. Copy the provided API and Secret keys into TWM Bybit connection set up parameters.
It is highly recomended to restrict access to your trusted IP. You can see what you IP is here https://whatismyipaddress.com/. Make sure you are not using dynamic IP that can change a few times even during one day.
You do need to give access to assets part of the API as shown above if you want to see your assets tab in TWM with remaining spot positions that you hold.
Important Information
- Please make sure that a chosen connection is available in your specific region or use a VPN if needed.
- When copying API keys and secrets make sure you do not copy any white space.
- TWM will attempt to download all available data the first time you ask for data no matter what period you ask for, please allow this first download to execute untill end.
- Upon creating the keys the system might ask you whether you would like system generated API keys or self generated API keys. It does not matter for TWM which ones you choose. You can read more about what the difference between them is upon creation in the information provided by the exchange.
- Upon API key creation do not forget to create a name for it, it does not matter for TWM what name you create, just a name that you can identify for your personal use. Some exchanges might not allow you to proceed without the name, watch out for hints from the exchange UI that can help you identify what is required to be filled in.
- If you are not able to connect for some reason after you have been using a connection for a while and you are sure its not an IP filter, check the expiry dates on your exchange API configuration. Some exchanges provide API keys that expire after a certain period.
- Remember that if you set up a connection without an api key and secret it will still connect to public data but you won't be able to trade or get your account balance. On the other hand if you do set up a connection and fill out the API keys and make a mistake in them or your API key expires, then you will not be able to connect and will get a generic "Check your credentials" warning message.