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.

caution

To Trade using your Binance account on Tealstreet, users must setup a Dual API key. Please review the Dual API section for more informaiton.

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

  • Second, log into your Tealstreet account.

tip

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

  1. Once you have successfully logged into Tealstreet, navigate to the header titled ‘API Keys’

  2. Click the blue button titled ‘New API Key’

Adding Api
  • Choose Binance from the dropdown menu.
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
  • Now you are ready to create the APIs you will need to Trade using Tealstreet. First we will start with the "Trading" API Key.

Trading API​

On the Create API page:

  1. 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 name on the Binance website.
  2. Click on the Create API 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 Trading API Key pair.
API Details
  1. Select the ‘Enable Futures’ option. Do not enable any other permissions.
  2. 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.
  3. ‘API Key’ - This is the key that will be pasted it into the Key field on Tealstreet.
  4. ‘Secret Key’ - This is the secret that will be pasted it into the Secret field on Tealstreet.
  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.

  1. Ensure you have selected ‘Binance’ in the Exchange dropdown menu.
Trade Api

  1. Consider using the Tealstreet referral link to help support Tealstreet development.

  2. Choose a name for this API connection. You will see the name on an API dropdown list 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.

  3. Choose your Encryption Password. Remember to save this somewhere!

  4. Paste the Trade API Key provided by Binance here.

  5. Paste the Trade API Secret provided by Binance here.

caution

Do NOT press confirm yet, we need to create a Read-Only API key.

Now you are ready to create the 'Read-Only' API key. Head on over to the Binance tab and:

  • Click on the User Icon.
  • Select API Management from the dropdown menu.
API Dropdown

Read-Only API​

On the Create API page:

  • Choose a name for your API Key. It can be helpful to choose a name like Read-Only-Tealstreet to distinguish between the Trade and Read APIs. You will only see this name on the Binance website.
  • Click on the Create API Button to start the key creation process.

API-Create

tip

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

  • 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 Read-Only API Key pair.

API-Detailed

  • Ensure that only "Reading" and "Unrestricted" are selected
  • ‘API Key’ - This is the key that will be pasted it into the Key field on Tealstreet.
  • ‘Secret Key’ - This is the secret that will be pasted it into the Secret field on Tealstreet.
  • Click ‘Save’
  • 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.

Trade-Tealstreet

  • 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. Navigate to the ‘Trade’ page of Tealstreet and select the Binance account from the dropdown menu. If properly linked, you will see your balance/collateral appear in the Margin window of Tealstreet.

note

Be sure to double check that you do not 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.