Appearance
Bitget – API Import Guide
This guide explains how to create and bind a Bitget API Key to your trading platform.
By connecting your Bitget account via API, you can enable automated trading, strategy execution and real-time account data access securely.
⚠️ Important Notes Before You Start
Before creating an API Key on Bitget, please note:
- You can create up to 10 API Keys per account.
- Each key has three credentials:
- APIKey – the public key for identification,
- SecretKey – the private key used for signing,
- Passphrase – a user-defined password required for authentication.
- Save your Passphrase and SecretKey securely — they are shown only once.
- Strongly recommend enabling IP Whitelist for security.
Step 1: Log in to Bitget
- Visit the official Bitget website
👉 https://www.bitget.com - Log in with your username and password.
- Make sure 2FA (Two-Factor Authentication) is enabled.
📸 Screenshot Example
Step 2: Navigate to API Management
- Click your profile avatar at the top-right corner of the screen.
- Select API Keys from the dropdown menu.
- The API Management dashboard will open.
📸 Screenshot Example
Step 3: Create a New API Key
- Click Create API Key.
- Choose System-generated API Key.
- Enter an API Name / Note (e.g.,
UFOX-Bitget-API). - Enter a Passphrase — keep this safe, as it cannot be recovered later.
📸 Screenshot Example
Step 4: Configure API Permissions (Very Important)
Bitget allows you to set different API permissions. Typical settings for automated trading:
✅ Permissions
- ☑️ Read – allows candle, order, and account data reads.
- ☑️ Trade (Read-Write) – allows placing and canceling orders.
- (Optional) Transfer – moves assets between sub-accounts.
- (Optional) Withdraw – enables withdrawals (only use with IP whitelist).
⚠️ Withdrawal permission is risky — enable only if absolutely necessary and with strict IP restrictions.
📸 Screenshot Example
Step 5: Set IP Access Restriction (Recommended)
- In the IP Whitelist field, enter the list of trusted IPs.
- Your trading platform’s IPs (provided by your platform).
- Enabling IP restriction significantly improves security.
📸 Screenshot Example
If you don’t have IPs yet, you may temporarily skip this step and update it later.
Step 6: Complete Security Verification
After setting the permissions:
- Click Next / Confirm.
- Complete email verification.
- Enter your 2FA code (Google Auth / SMS).
- Bitget will show your:
- API Key
- Secret Key
- Passphrase
📸 Screenshot Example
⚠️ Save the SecretKey and Passphrase securely — they will not be shown again.
Step 7: Bind API Key on the Trading Platform
- Go to Account → API Management in your platform’s dashboard.
- Select Bitget as the exchange.
- Enter:
- API Key
- Secret Key
- Passphrase
- Select scopes:
- Spot / Futures / Both (depending on strategy).
- Click Bind / Connect.
📸 Screenshot Example
Step 8: Verify Connection Status
Once bound:
- ✅ API Status: Connected
- 📊 Account balances updated
- 🤖 Strategies available
📸 Screenshot Example
Common Errors & Solutions
❌ Invalid API Key / Secret / Passphrase
- Double-check for extra spaces.
- Ensure you copied the correct keys.
- If lost, delete and recreate the API.
📸 Screenshot Example
❌ Permission Denied
- Ensure Trade is enabled for trading strategies.
- For futures execution, enable appropriate permissions.
❌ IP Whitelist Rejection
- Add correct platform IPs.
- Or temporarily disable IP restriction for testing.
Security Best Practices
- 🔐 Use dedicated API Keys per platform.
- 🔄 Rotate keys periodically.
- 🚫 Disable unused permissions.
- 🛑 Delete old or compromised keys immediately.
FAQ
What permissions should I set?
Mostly Read + Trade (Read-Write).
Avoid Withdraw unless needed with restricted IP.
Can I modify API permissions later?
Yes — permissions and IP whitelist can be updated anytime.
How many API keys can I create?
Bitget allows up to 10 API Keys per account.
🎯 Finished
Your Bitget account is now connected and ready for automated or quantitative trading.
For more guides, please refer to other exchange API import documentation.