Setup Guide

Binance API key (sub-account + futures)

Best practice: a separate sub-account for the bot, so its trades never mix with your own funds and trades. The order matters: enable futures first, then create the API key.

TeleRoyal
YOUR FUNDS. YOUR CONTROL.
Security reminder Never enable withdrawals on the API key.

The bot only needs reading and futures trading permissions. Keep your account secure by following the steps below.

1

Prerequisite: identity verification and 2FA

Your Binance account must complete identity verification (KYC) and have two-factor authentication (2FA) enabled.

  • KYC (Identity verification)
  • 2FA (Authenticator / Passkey)
Account securityEXAMPLE
Identity verification (KYC)Two-factor authentication (2FA)
2

Create a sub-account (recommended)

Create a dedicated sub-account for the trading bot to keep your main account separate and more secure. Go to Account › Sub-Accounts, click Create Sub-Account, set a name, and confirm.

Sub-accountsEXAMPLE

Keep your bot’s funds separate from your main account.

3

Enable futures for the sub-account before creating the key

Before creating the API key, enable Futures for the sub-account. Open Futures, click Enable, and accept the Futures agreement.

Futures tradingEXAMPLE
Enable Futures before creating your API key.USDⓈ-M / COIN-M
4

Create the API key

In the sub-account, go to API Management, click Create API, choose System generated API, and continue.

API ManagementEXAMPLE
API key nameTeleRoyal BotKey type: system generated
5

Permissions and IP lock

Enable Read Info and Futures. Disable Withdrawals and Internal Transfer. Restrict access to trusted IPs only and add the TeleRoyal server IP shown below.

127.0.0.1
API permissionsEXAMPLE
Read + FuturesWithdrawals & transfers disabled127.0.0.1
6

Enter the keys in TeleRoyal

In TeleRoyal, open your exchange accounts and choose Add Exchange. Select Binance, then paste your API Key and API Secret from Binance.

Add your exchangeEXAMPLE
API Key + API Secret

Use the secure exchange form to validate your keys and balance.

Add Exchange
7

Test connection

Click Check API key & balance in TeleRoyal. Verify that the keys work and have the correct permissions, then save your exchange account.

Check your API keyEXAMPLE
API Key + API Secret

Use the secure exchange form to validate your keys and balance.

Add Exchange

8Common errors and fixes

Here are common issues when connecting Binance and how to resolve them.

Error / MessagePossible causeFix
Invalid API key or signatureThe API key or secret is incorrect.Copy both values from Binance and paste again.
IP not allowedThe server IP is missing from the allowlist.Add 127.0.0.1 to the IP allowlist.
Futures not enabledFutures is not enabled for the sub-account.Enable Futures in the sub-account, then retry.
Insufficient permissionsRequired permissions are not enabled.Enable Read Info and Futures only.
Sub-account not foundThe API key belongs to another account.Use the API key and secret from the correct sub-account.

Supported exchange examples

TeleRoyal supports major crypto exchanges, including:

OKXBitgetKuCoin

Use the same API rules on other supported futures exchanges.

Security reminder

  • Use a dedicated sub-account when possible.
  • Grant only Read and Trade Futures / Contracts permissions.
  • Do not enable Withdraw or Transfer.
  • Always whitelist / bind the TeleRoyal server IP.
  • Keep your API Key, Secret, and Passphrase private and secure.

You’re all set!

Create your API key with the settings above, then add it to TeleRoyal to start automated trading.

Add Exchange