Connecting your OKX exchange account to Altrady streamlines your crypto trading experience by enabling unified portfolio management, real-time balance tracking, and efficient trade execution—all from a single intuitive interface. Whether you're managing multiple exchanges or just getting started with Altrady, linking your OKX account is a crucial step toward maximizing your trading efficiency.
This guide walks you through two reliable methods to connect your OKX account: Fast Connect for automatic setup and Manual Connection for full control over API configuration. We’ll also cover how to sync your balances and troubleshoot common issues.
Fast Connect: Quick & Secure Integration
Fast Connect simplifies the integration process by automating the creation and configuration of your OKX API key directly within Altrady. This method eliminates the need to manually generate keys, set permissions, or input IP whitelists—everything is handled securely behind the scenes.
Note: Fast Connect can only be used when creating a new trading account in Altrady. If you're replacing an existing API key, use the Manual Connection method instead.
Step-by-Step: Fast Connect Setup
- Open Altrady Settings
From the left-side navigation panel, click Settings, then select Exchange Account API Keys. - Initiate Account Connection
Click the + Connect Account button to begin the process. - Select OKX Exchange
Choose OKX from the list of available exchanges. Enable Fast Connect Mode
Ensure that Fast Connect is selected (it’s usually the default). Click Connect to be redirected to the OKX login page.👉 Get started with seamless exchange syncing using automated tools
If you're already logged into OKX on the same browser, the redirect may skip the login prompt.
- Log In to OKX
Choose your preferred authentication method (email, phone number, or sub-account) and follow the prompts. You may be asked to enter a password on the next screen. Authorize API Key Creation
After successful login, OKX will display a permission request. Click Confirm to allow Altrady to generate an API key with the necessary trading and read permissions.- The system automatically assigns correct permissions.
- Altrady’s IP whitelist is applied to enhance security.
- Verify Successful Connection
Once confirmed, you’ll see a success message both on the redirect page and inside Altrady. Your new trading account will appear under Exchange Account API Keys. - Customize Account Label (Optional)
You can rename the account by clicking Edit and updating the Account Label for easier identification. - Sync Balances if Needed
If your balance isn't visible immediately, proceed to the Syncing Balances section below.
Troubleshooting Tips:
- If you receive an error stating a Fast Connect API key already exists, note that OKX allows only one per account.
- Subscription limits may prevent creating additional trading accounts—check your Altrady plan.
Manual Connection: Full Control Over API Setup
For advanced users who prefer hands-on configuration, Manual Connection gives you complete control over API key creation, permissions, and security settings.
Step 1: Create API Key on OKX
- Open your browser and go to the OKX website.
- Log in to your account.
- Click on APIs in the top menu, then select Create APIs.
Step 2: Configure API Settings
- Name Your API Key – Use a descriptive label like “Altrady_Trading”.
- Select Account Type – Choose between main or sub-account based on your needs.
- Set Purpose – Select API Trading.
Step 3: Prepare in Altrady
While keeping the OKX tab open, switch to another tab and:
- Go to Settings > Exchange Account API Keys in Altrady.
- Click + Connect Account, then choose OKX.
- Select Manual Connect.
- Enter an Account Label for easy reference.
- (Optional) Click the copy icon next to Altrady’s IP whitelist and paste all 20 IP addresses into OKX later for enhanced security.
Step 4: Finalize API Key on OKX
- Return to your OKX tab.
- Paste Altrady’s IP addresses into the IP whitelist field.
- Enable Read and Trade permissions.
- Create and securely store a passphrase—you’ll need this during setup.
- Click Submit All.
Step 5: Complete Authentication
- A 2FA pop-up will appear—request codes via SMS and email.
- Enter both codes and click Confirm.
- Upon success, click Show Info to reveal your API key and Secret.
🔐 Never share or expose your Secret key or passphrase.
Step 6: Link Keys in Altrady
- Copy the API Key, Secret, and Passphrase from OKX.
- Paste them into their respective fields in Altrady.
Verify the correct API version:
- If created at my.okx.com, ensure version matches accordingly; otherwise, connection errors may occur.
- Click Save in Altrady.
👉 Securely manage multiple exchange accounts from one dashboard
Your new trading account will now appear under Exchange Account API Keys.
✅ To update an existing connection, click Edit on the current account instead of creating a new one.
Syncing Balances
After connecting your account, it may take a moment for balances to appear in Altrady. To manually refresh:
- Navigate to the Exchange Account API Keys page.
- Locate your connected OKX account.
- Click the refresh icon or wait for automatic synchronization (typically within 1–2 minutes).
If balances still don’t appear:
- Confirm that Read permission is enabled on your API key.
- Ensure no network issues are affecting data retrieval.
- Double-check that your API version matches the platform used during creation.
Frequently Asked Questions (FAQ)
Can I use Fast Connect if I already have an OKX API key?
No. Fast Connect only works when setting up a new trading account. If you already have a connected OKX account in Altrady, use Manual Connection to replace or update the API key.
Why can’t I create more than one Fast Connect API key?
OKX restricts users to one Fast Connect API key per account for security reasons. Attempting to create another will result in an error.
Is it safe to whitelist Altrady’s IP addresses?
Yes. Whitelisting ensures that only authorized servers can access your API, reducing the risk of unauthorized usage. Always combine this with strong passphrase protection and restricted permissions.
What permissions does the API key require?
Your API key must have:
- Read permission – To view balances and transaction history.
- Trade permission – To execute buy/sell orders through Altrady.
Avoid enabling withdrawal permissions unless absolutely necessary.
Can I connect a sub-account?
Yes. During manual setup on OKX, simply select your sub-account before generating the API key. This allows you to manage sub-portfolios separately within Altrady.
Why am I getting an “account not found” error?
This usually occurs when the API version doesn’t match where the key was created:
- Keys from www.okx.com should use standard version settings.
- Keys from my.okx.com require specific version selection in Altrady.
Double-check the source URL and adjust accordingly.
By following these steps, you can securely integrate your OKX exchange with Altrady for streamlined portfolio tracking and optimized trading performance.
👉 Maximize your crypto portfolio control with advanced exchange linking features
Whether you choose Fast Connect for speed or Manual Connection for precision, both methods offer secure, reliable access to your assets—all while maintaining full control over permissions and security settings.
Start managing your crypto journey smarter today.