API Key Setup Guide

⚠️

Critical Security Warning

Never share your API Secret Key with anyone. EnigmAPI will NEVER ask for your API secret via email, chat, or phone. Keep your secret key secure and enable IP whitelist restrictions whenever possible.

Create or Log Into Your Binance Account

Before you can create API keys, you need an active Binance account.

Visit Binance.com and sign in to your account
Complete any required security verifications (2FA, email confirmation, etc.)
Ensure your account has completed KYC verification for full API access

ℹ️

Note: Some API features may require Identity Verification (KYC). Make sure your account is fully verified.

Navigate to API Management

Click on your profile icon in the top right corner
Select "API Management" from the dropdown menu
You may be asked to complete 2FA verification

Screenshot: Binance Profile Menu - API Management

Create New API Key

Click "Create API" button
Choose "System generated" for the API key type
Enter a label/name for your API key (e.g., "EnigmAPI Trading Bot")
Complete the security verification (2FA, email, SMS)

Screenshot: Create API Key Dialog

💡

Important: Your API Secret will only be shown ONCE. Make sure to copy it immediately and store it securely.

Configure API Permissions

Enable the following permissions for EnigmAPI to function properly:

📖 Enable Reading Required

Allows EnigmAPI to read your account balance, positions, and trade history

📊 Enable Spot & Margin Trading Required

Enables spot and margin trading execution through the bot

📈 Enable Futures Required

Required if you want to trade futures contracts

🔒 Restrict IP Access Recommended

Whitelist only EnigmAPI server IPs for enhanced security

🚫

Do NOT Enable: Do not enable "Enable Withdrawals" permission. EnigmAPI only needs trading permissions, never withdrawal access.

Screenshot: API Permission Settings

Set Up IP Whitelist (Recommended)

For maximum security, restrict API access to only EnigmAPI's server IP addresses:

🌐

EnigmAPI Server IPs:

                                                52.91.184.22

                                                34.201.45.189

                                                54.167.23.45

Add all three IP addresses to your whitelist

In the API Management page, find "Restrict access to trusted IPs only"
Enable the restriction toggle
Add each EnigmAPI server IP address listed above
Save your changes

✅

With IP whitelisting enabled, your API keys can only be used from EnigmAPI servers, significantly improving security.

Copy and Save Your API Keys

Copy your API Key (this is your public key)
Copy your API Secret (shown only once - do not lose this!)
Store both keys in a secure location temporarily
Never share these keys via email, chat, or screenshots

⚠️

Last Chance! The API Secret is only shown once during creation. If you lose it, you'll need to create a new API key.

Enter Keys in EnigmAPI

Go to the API Setup page in your EnigmAPI dashboard
Paste your API Key in the "API Key" field
Paste your API Secret in the "API Secret" field
Click "Save & Test Connection"

✅

Success! EnigmAPI will test your connection and verify all required permissions are enabled. If the test passes, you're all set!

Screenshot: EnigmAPI API Setup Page

🔒

Security Best Practices

Enable 2FA on Binance: Always use Two-Factor Authentication on your Binance account for an extra layer of security
Never Enable Withdrawals: Your API keys should never have withdrawal permissions enabled
Use IP Whitelisting: Always restrict API access to known IP addresses when possible
Rotate Keys Regularly: Consider creating new API keys every 3-6 months
Monitor Activity: Regularly check your Binance trade history and EnigmAPI logs for any suspicious activity
Delete Unused Keys: If you stop using EnigmAPI, delete the API keys from Binance immediately

🔧

Troubleshooting Common Issues

❌ "Invalid API Key" Error

This error occurs when the API key format is incorrect or the key doesn't exist.

Solution:

Double-check you copied the entire API key without extra spaces
Verify the API key still exists in your Binance API Management page
Try creating a new API key if the issue persists

❌ "Permission Denied" Error

This means your API key doesn't have the required permissions enabled.

Solution:

Go back to Binance API Management
Edit your API key and enable "Enable Reading", "Enable Spot & Margin Trading", and "Enable Futures"
Save changes and try again in EnigmAPI

❌ "IP Not Whitelisted" Error

Your API key has IP restrictions, but EnigmAPI's IPs are not in the whitelist.

Solution:

Add EnigmAPI server IPs to your Binance API whitelist (see Step 5 above)
OR temporarily disable IP restrictions for initial setup (not recommended)

❌ "Signature Invalid" Error

The API secret doesn't match the API key, or there's a time synchronization issue.

Solution:

Verify you entered both the correct API Key AND API Secret
Make sure there are no extra spaces before or after the keys
If copied incorrectly, you'll need to create a new API key

❌ Connection Test Takes Too Long

The test is timing out or taking more than 30 seconds.

Solution:

Check if Binance is experiencing downtime or maintenance
Try again in a few minutes
Contact EnigmAPI support if the issue persists

🧪

Testing Your API Connection

After setting up your API keys, EnigmAPI performs several tests:

Connection Test: Verifies EnigmAPI can communicate with Binance using your keys
Permission Test: Checks that all required permissions are enabled
Balance Check: Retrieves your account balance to confirm read access
Test Order (Optional): Places and immediately cancels a test order to verify trading permissions

✅

All Tests Passed? Congratulations! Your API connection is set up correctly and EnigmAPI can now execute trades on your behalf.

Official documentation