Skip to main content

Binance

binance-Logobinance-Logo

Connecting Binance to Tealstreet​

note

Binance users are required to complete KYC before creating new trading API Keys.

  • First, make sure you are logged into your Binance account.

  • Second, log into your Tealstreet account.

    • Depending on when you made your account and when we did the snapshot, you might need to make a new account for v3.
tip

Its a good idea to keep both Tealstreet and Binance windows open.

  • Click the 'Settings' button near the top right corner of the terminal.
Adding API
  • Choose Binance from the dropdown menu.
TS Dropdown

  • Now you are ready to generate the API Keys within your Binance Account. Head on over to the Binance tab and:

    • Click on the User Icon.
    • Select API Management from the dropdown menu.
API Dropdown
  • Choose System Generated and then click Next.
System Generated Key
  • Now you are ready to create the APs you will need to Trade using Tealstreet.

Create the API​

On the Create API page:

  • Choose a name for your API Key. It can be helpful to choose a name like Trading-Tealstreet to distinguish between the Trade and Read APIs. You will only see this label on the Binance website.
    • When done click on the Next button to start the key creation process.

API-Create

tip

You can get to this page directly by navigating to this link

  1. Once you have created the API Key on Binance, you need to click the yellow button titled ‘Edit Restrictions.
API Restrictions
  • Now you are ready to choose the settings of your API Key.
API Details
  1. ‘API Key’ - This is the key that will be pasted it into the Key field on Tealstreet.
  2. ‘Secret Key’ - This is the secret that will be pasted it into the Secret field on Tealstreet.
  3. Select the ‘Enable Futures’ option. Do not enable any other permissions.
  4. Copy the list of IP Addresses from Tealstreet and then paste them into the ‘Restrict access to trusted IPs only’ field on the edit permissions window of Binance.
    • You need to hit the confirm button after you paste in the IPs in order for them to save properly.
  5. Click ‘Save’
caution

Users MUST use the Whitelisted IP Addresses when creating this API. Please Ensure all IP addresses are correct as shown in the Tealstreet terminal window (images below/above are for reference only)

API-Whitelist

note

After editing Key permissions, the dropdown arrow at the top right will minimize the editable fields. Once you minimize this area, you will no longer be able to see your API secret. Make sure you have it saved!

caution

Never share your API Keys with anyone.

Once you have created the API Key on Binance’s website, you are ready to fill out the information on Tealstreet’s API KEYS page.

  • Ensure you have selected ‘Binance’ in the Exchange dropdown menu.
    • Consider using the Tealstreet referral link to help support Tealstreet development.
Trade Api

  • This guide assumes you will use the Tealstreet network for trading and have whitelisted the IP's in the previous section.

    • If you want to use a custom setup or service such as TraderWagon you won't enable this option and will enter custom IP whitelisting.

  • Choose a name for this API connection. You will see this name on an API on the trading page of the Tealstreet terminal. This is helpful for traders who utilize multiple accounts and/or sub accounts per exchange and want to distinguish between them.

  • Paste the API Key provided by Binance here.

  • Paste the API Secret provided by Binance here.

  • Once you have all the information filled out including both API keys. Press Create.

  • If all the details are correct, you will have successfully linked your Binance account to Tealstreet. Close the Settings page of Tealstreet and Tealstreet will automatically activate and select your most recently added key. If properly linked, you will see your balance/collateral appear in the Margin module of Tealstreet.

note

Be sure not to confuse API Key and API Secret. Connecting your Binance exchange account to Tealstreet will not work if these fields are not entered correctly.

Troubleshooting​

In this section we will go over some of the Binance specific issues that may arise.

Error about unable to adjust margin mode​

API Dropdown
  • For now Tealstreet only supports single-asset-mode not the new multi-asset-mode. See more here

Error about order position side not matching​

Position Side
  • Please double check your hedge mode vs one-way settings.

Error about "Trading key - invalid api key, ip, or permissions for action"​

wrong account / permission type
  • Please ensure you are using a futures trading account. Tealstreet does not currently support spot trading.
    • Also please ensure you selected the correct permissions for the API key.