Integrating your trading platform with OKX via an API key unlocks powerful automation capabilities, advanced analytics, and seamless execution across markets. Whether you're connecting to a third-party application like Insilicoterminal or setting up a custom integration, generating a secure and properly configured API key is essential. This guide walks you through the complete process of creating an OKX API key, configuring permissions, and securely linking it to external platforms.
Accessing the API Key Section
To begin, log in to your OKX account. In the top-right corner of the dashboard, click on your user icon to open the dropdown menu. From there, select API keys. This will redirect you to the API management interface where you can view existing keys or generate new ones.
Alternatively, you can navigate through the settings menu: go to Accounts, then switch to the OKX tab, where you’ll find a direct link labeled "OKX API Keys".
👉 Generate your secure API key in minutes and start connecting to advanced trading tools.
Creating a V5 API Key
Once in the API keys section, click on Create V5 API Key. You'll be presented with a form that allows you to customize the access and security settings for your new key.
Selecting the Use Case
In the form, choose Linking third-party apps as your use case. If you're integrating with Insilicoterminal, select it from the list of available applications. By choosing this option, OKX automatically restricts the API key to only communicate with Insilicoterminal’s server IP addresses—enhancing security by preventing unauthorized access from unknown locations.
This pre-configured restriction eliminates the need to manually whitelist IPs, reducing setup complexity and minimizing configuration errors.
Configuring Key Details and Security
Now it's time to define your key’s identity and security parameters:
- Key Name: Enter a descriptive name for easy identification (e.g., “Insilico_Trading_Bot”).
- Passphrase: Create a strong passphrase and store it securely. This is not your account password—you must save this passphrase, as it will be required when adding the API credentials to the terminal or any connected service.
- Permissions: Enable Trade permission if you intend to place orders through the API. For read-only access (such as viewing balances or market data), leave trade permissions disabled.
After filling out these fields, click Confirm. You'll be prompted to enter a verification code from your two-factor authentication (2FA) method—this adds an additional layer of protection during key creation.
Retrieving Your API Credentials
Upon successful verification, OKX will display your generated credentials:
- API Key
- Secret Key
- Passphrase
These three components are critical for establishing a secure connection. Copy them immediately and store them in a secure password manager or encrypted vault. The secret key will not be shown again for security reasons.
⚠️ Never share your API secret or passphrase. Treat them like your login credentials.
👉 Securely connect your trading tools and unlock automated strategies today.
Connecting to Insilicoterminal
Now that your API key is created, proceed to the Insilicoterminal platform.
- Navigate to the Settings section.
- Go to the Account tab.
- You’ll see a screen prompting you to add a new account.
Here, enter the following:
- A recognizable account name
- The API key copied from OKX
- The Secret key
- The Passphrase you created earlier
Ensure all fields are filled correctly. Once submitted, the terminal will validate the credentials and establish a secure connection with your OKX account.
Manual Setup: Whitelisting Terminal IP Addresses
If you prefer not to use the pre-linked third-party app option, you can create a general-purpose API key and manually configure IP restrictions.
When creating the key, skip selecting Insilicoterminal and instead choose Customized under IP binding. Then paste the following comma-separated list of Terminal server IP addresses into the whitelist field:
18.167.89.125,18.167.8.216,43.198.26.42,18.166.216.236,18.163.207.89,43.198.196.202,43.198.149.125,43.198.214.66,18.167.53.222,18.166.252.235,16.163.177.207,18.167.243.99,18.167.32.21,18.166.224.0,18.166.106.248,18.162.176.190,16.163.65.4,18.167.188.106,16.163.19.198,18.167.49.196This ensures that only requests originating from Insilicoterminal’s servers can access your account via the API.
Manual whitelisting offers flexibility but requires extra diligence—double-check each IP and avoid leaving the field blank, which would allow unrestricted access.
Best Practices for API Key Security
To protect your assets and maintain control over your trading environment:
- Always enable 2FA on your OKX account.
- Use unique passphrases for each API key.
- Limit permissions to only what’s necessary (e.g., disable withdrawal rights).
- Regularly review active API keys and revoke unused ones.
- Monitor API activity logs for suspicious behavior.
Frequently Asked Questions
How do I recover my API secret key if I lose it?
You cannot recover a lost API secret key. If misplaced, you must delete the existing key and generate a new one through the OKX API settings.
Can I use the same API key for multiple platforms?
While technically possible, it's not recommended for security reasons. Use separate keys for different applications so you can isolate access and minimize risk.
Why do I need to whitelist IP addresses?
IP whitelisting restricts API access to trusted servers only, preventing attackers from using your credentials even if they are compromised.
What does enabling 'Trade' permission allow?
Enabling trade permission allows the connected application to place buy/sell orders on your behalf through the OKX trading API.
Is it safe to link my account to a third-party terminal?
Yes—provided you trust the platform and follow security best practices such as using strong passphrases, limiting permissions, and monitoring activity.
Can I change API permissions after creation?
No—once an API key is created, its permissions cannot be modified. To change access levels, you must create a new key with updated settings.
👉 Maximize your trading efficiency with secure API integration—get started now.
Final Thoughts
Setting up an OKX API key is a straightforward yet crucial step in expanding your trading capabilities beyond manual execution. Whether leveraging automated bots or integrating with analytics dashboards, proper configuration ensures both performance and protection.
By following this guide, you’ve learned how to generate a secure V5 API key, link it to Insilicoterminal—either through automated app linking or manual IP whitelisting—and maintain control over your digital assets with robust security practices.
Stay proactive: regularly audit your connected apps and refresh credentials as needed to keep your trading ecosystem resilient and efficient.
Core Keywords: OKX API key, create API key, Insilicoterminal integration, API security, trade permission, IP whitelisting, passphrase setup