Setting up API keys on OKX is a crucial step for traders who want to connect their exchange accounts to third-party platforms like portfolio managers, trading bots, or automated systems. Whether you're engaging in Spot trading, Futures trading, or both, properly configured API keys allow seamless integration while maintaining security. This comprehensive guide walks you through the entire process—from enabling Futures trading to generating secure API credentials on OKX.
Enable Futures Trading on OKX (Optional)
If you plan to trade or automate Futures positions via an external platform, you must first activate Futures trading on your OKX account. Skip this section if you're only using Spot markets.
👉 Learn how to securely link your exchange for automated trading strategies.
- Log in to your OKX account
Navigate to the official OKX website and sign in with your credentials. - Upgrade your account level
OKX requires users to complete a verification and risk assessment process before enabling Futures trading. You’ll be prompted to confirm your understanding of derivatives risks. Once confirmed, click “Upgrade to trade”. - Access account settings
After upgrading, locate the Settings icon (⚙️) at the top-right corner of the dashboard and click it. - Select Futures trading tier
Choose a Futures trading mode based on your experience and risk tolerance. OKX offers multiple levels—each with different leverage and margin requirements. Confirm your selection.
✅ At this point, Futures trading is now enabled on your account.
You can now proceed to create API keys that support both Spot and Futures operations.
How to Create API Keys on OKX
API keys act as secure access tokens that allow external services to interact with your OKX account without sharing your login details. Follow these steps carefully to generate a fully functional API key.
Step 1: Navigate to the API Management Section
- Hover over your profile icon in the upper-right corner.
- Click on API from the dropdown menu.
🔒 Note: You must have Two-Factor Authentication (2FA) enabled to create or manage API keys. If prompted, follow OKX’s instructions to set up Google Authenticator or SMS verification.
Step 2: Generate a New API Key (V5)
OKX uses the V5 API framework, which supports both Spot and derivatives markets.
- Click “Create API Key V5”.
- Enter a custom name for your key (e.g., “3Commas Bot” or “Trading Dashboard”). Naming helps identify usage across multiple integrations.
Step 3: Set an API Password
- Input your account password—this is your personal login password, not a new one.
- This step verifies your identity during key creation.
📌 Important: You will need this same password when linking your API to third-party platforms like trading bots or analytics tools.
Step 4: Configure IP Restrictions (Optional)
By default, leave the IP whitelist field blank unless you have strict security requirements and know the static IP addresses that will access the API.
Leaving it empty allows flexibility, especially when using cloud-based trading services or changing networks frequently.
⚠️ Warning: If you do enter IP addresses, ensure they are accurate—any mismatch will block API access.
Step 5: Assign Proper Permissions
Permissions define what actions the API key can perform. For most automation tools, select:
- ✅ Trade (Read & Write) – Allows placing and managing orders
- ✅ Account (Read-only) – Enables balance checks and position tracking
- ❌ Avoid enabling Withdrawal permissions unless absolutely necessary
👉 Discover how top traders use API integrations for smarter execution.
For full functionality with platforms supporting both Spot and Futures:
- Ensure Futures & Perpetuals permissions are enabled
- Confirm Spot/Margin access is also checked
These settings allow unified management of all trading types through a single key.
Step 6: Complete 2FA Verification
Enter the code generated by your 2FA app (e.g., Google Authenticator) and click Confirm.
Upon successful verification, OKX will display your newly created API credentials:
- API Key
- Secret Key
- Passphrase (the one you entered earlier)
🔐 Critical Security Tips:
- Never share these keys publicly
- Store them in a secure password manager
- Avoid saving them in plain text files or spreadsheets
- Revoke any compromised keys immediately via the API management panel
Connect Your OKX Account to Third-Party Platforms
With your API keys generated, you can now link your OKX account to platforms such as trading bots, portfolio trackers, or copy-trading services.
When adding the exchange:
- Paste the API Key, Secret, and Passphrase
- Select whether to enable Spot, Margin, or Futures trading
- Test the connection before activating live trades
✅ Done! Your OKX account is now ready for automated or enhanced trading workflows.
Frequently Asked Questions (FAQ)
Q1: Do I need to enable Futures trading to create an API key?
No. You can create an API key for Spot trading only without enabling Futures. However, if you want to manage Futures positions via API, Futures trading must be activated first.
Q2: Can one API key access both Spot and Futures accounts?
Yes. A single API key can be configured with permissions for both Spot/Margin and Futures/Perpetuals, allowing centralized control across markets.
Q3: Is it safe to use API keys with third-party apps?
Yes—if done correctly. Only grant necessary permissions (avoid withdrawals), use strong passwords, enable 2FA, and monitor activity regularly. Revoke unused or suspicious keys promptly.
Q4: What should I do if my API key is exposed?
Immediately go to the API Management section on OKX and revoke the compromised key. Then generate a new one with the same permissions.
Q5: Why can’t I see the API option on my OKX account?
Ensure you’re logged into a personal account, not a sub-account (unless API access is delegated). Also, verify that 2FA is enabled—this is required before accessing API settings.
Q6: Can I restrict an API key to read-only mode?
Absolutely. During setup, uncheck “Trade” permissions and keep only “Account – Read” access. This is ideal for analytics tools or monitoring dashboards that don’t execute trades.
Final Thoughts
Creating API keys on OKX is a straightforward yet powerful way to unlock advanced trading capabilities. Whether you're automating strategies, tracking performance, or managing risk across Spot and Futures markets, proper API configuration lays the foundation for success.
Always prioritize security: use unique names, strong authentication, and minimal permissions. And remember—your keys are as valuable as your funds.
👉 Start optimizing your crypto workflow with secure exchange connectivity today.
All other external links have been removed per guidelines.