Articles on: Exchanges

How to Connect Your OKX Exchange Account with Altrady

Overview


Connecting your OKX exchange account to Altrady allows for seamless trading and portfolio management of your OKX account.


The following article will describe two straightforward methods of connecting your OKX account (Spot and/or Futures):


  1. Fast Connect, for quick and automatic setup.
  2. Manual Connection, for users who prefer a more hands-on approach.


See the differences below.


Fast Connect, simplifies the process by:

  • Redirecting you to OKX for a secure login.
  • Automatically generating, configuring and connecting the OKX API key (with the correct permissions).
  • Automatically applying Altrady’s IP whitelist to the API key.


Fast Connect is only available if your OKX url is www.okx.com (i.e. OKX global). It will not work with other OKX sites including MY.okx or APP.okx. Use the manual method for these OKX sites.


Manual Connection, by contrast, involves:

  • Manually logging into OKX.
  • Manually creating the API key.
  • Copying and pasting the API and Secret key into Altrady.
  • Manually setting permissions.
  • Pasting Altrady's IP whitelist addresses in OKX (for non third-party API keys only).


Whether you're new to Altrady or simply linking a new exchange, follow the step-by-step instructions below, to get started with ease.


Altrady supports both Spot and Futures for OKX.


Contents

OKX Futures for EEA residents

Fast Connect

Manual Connection

Syncing Balances


OKX Futures for EEA residents (X-Perps)

If you live in the EEA (the EU plus Norway, Iceland and Liechtenstein), OKX provides futures as X-Perps: USDC-margined perpetuals offered by OKX Europe Markets Ltd under MiFID rules, on my.okx.com. This is a separate product from OKX's standard (global) USDT futures, and you must enable it on OKX before futures will appear in Altrady.


X-Perps cover both crypto and TradFi underlyings (major US stocks, commodities such as gold and oil, and index ETFs like SPY and QQQ) and are long expiry-date futures. They are all USDC-margined and are unlocked by the same appropriateness assessment, so the steps below apply to all of them. Availability can vary by EEA country.


Before you connect to Altrady, complete these steps on OKX:


  1. Complete identity verification (KYC). This must be done before you can unlock X-Perps.


  1. Unlock X-Perps by completing the appropriateness assessment. On desktop, go to Trade > Unlock X-Perps. This opens the appropriateness assessment, a short, mandatory questionnaire about your knowledge and experience with leveraged derivatives, required under MiFID rules. Completing the assessment is what unlocks X-Perps; it is a one-time process and cannot be skipped. If you do not pass, OKX applies a cooling-off period before you can retake it, so answer carefully. Once unlocked, X-Perps appears under your Trade menu; open an order there to confirm your account is enabled before connecting to Altrady.


  1. Create your API key with the Trade permission. OKX API keys have only three permissions: Read, Trade and Withdraw. There is no separate "futures" permission; once your account is enabled for X-Perps, a Trade-permission key can trade them. Then follow Manual Connection below, making sure the API version is set to my.okx.com.


Because EEA accounts are on my.okx.com (not www.okx.com / OKX global), Fast Connect is not available, so use Manual Connection (see below).


  • Once your API key is connected, find X-Perp crypto derivatives under Xperp in the Markets widget (see image below).
  • You can also trade the USDC-margined TradFi pairs; these are also X-Perps.



Still only seeing Spot in Altrady? Check that:


  • your OKX account has passed the appropriateness assessment and X-Perps is visible under Trade on OKX,
  • your API key has the Trade permission,
  • you connected via Manual Connection with the my.okx.com API version, and
  • your funds are in the Trading account on OKX, not Funding (see Syncing Balances).


Note: X-Perps are leveraged products with a long expiry date. Leverage can amplify both gains and losses, and losses can occur quickly.


Fast Connect


Fast Connect is a quick and automated way, to link your OKX exchange account to the Altrady platform without manually creating and copying the API and Secret keys.


Fast Connect can only be used to create new Trading Account(s) in Altrady. If you already have a Trading Account for OKX and need to replace the API key or IP whitelist, refer to Step 9 in the following section: Manual Connection


Step-1: In Altrady, click on Settings from the left side panel. Then, click on Exchange Account API Keys.




Step-2:  Click + Connect Account.




**Step-3: **From the dropdown list select OKX.




Step-4: Ensure Fast Connect is selected. Then click Connect, to be redirected to the OKX log in page.


If you're already logged into OKX on the same browser, you will not be asked to log in again.




While being redirected to OKX, the window below will be shown. If the redirect does not occur automatically, or if it takes a long time, the "OKX Fast Connect" button can be clicked to expedite the process.



Step-5: Select the login method and enter your login credentials as requested by OKX, before clicking Next.



Step-6: If the login method selected was phone number or email/sub-account, you will also be required to enter a password on the following screen. Once entered, click Log In.



Step-7: After logging in, the following screen will be displayed. Click Confirm to allow Altrady to create the Fast Connect API key.


The Fast Connect API key will be created with the same permissions as shown here, on Step 6: Manual Connection. Altrady's IP whitelist will be automatically linked to the Fast Connect API key.




Step-8: The messages below will be shown on the redirect page and in Altrady, if the Fast Connect API key was created successfully.


Message on the redirect page, stating that the Fast Connect API key was created successfully


Message in Altrady, stating that the Fast Connect API key was successfully created

Step-9: Finally, click Next to complete the Fast Connect.


Spot and Futures accounts will be created as separate accounts, even though the balance is shared. Make sure that the funds are moved from Funding to Trading account on OKX in order for Altrady to recognize it.


Step-9: Troubleshooting


The error message below will be shown, if there is already a Fast Connect API key that exists on the OKX account. OKX does not allow more than 1 Fast Connect API key to be created, per account.

To fix, either:

  • Log into the exchange and delete the existing Altrady Fast connect API key
  • Add an API key manually instead


Error message that is displayed if there is already 1 Fast Connect API key on the exchange account


An error message can also be shown, if the Fast Connect Trading Accounts cannot be created, due to a limit on the number of Trading Accounts for the current Altrady subscription plan.


Error message that is displayed if the number of Trading Accounts to be created exceeds the current plan's limit


Step-10: The newly connected Trading Account can then be viewed from the Exchange Account API Keys page.


The default name of the Fast Connect Trading Account can be changed at any time by clicking "Edit" and changing the "Account Label".



If your balance is not displayed immediately, refer to the section below: Syncing Balances. The video shows how to sync your exchange balance with Altrady.


Manual Connection


Third-Party


Step-1:


  1. Log into OKX.



Step-2:


  1. Click on the "APIs" button
  2. Click on "Create APIs".



Step-3:


  1. Assign a name to the API key.
  2. Select the account to create an API key for. If you're creating an API key for a subaccount, select your subaccount here.
  3. Set the purpose to "Linking third-party app".





Step-4:


  1. Select Altrady BV as the app name.
  2. Set "Trade" within the permissions.
  3. Create and enter a passphrase (take note of the passphrase as it will be required later).
  4. Click** "Submit All"**.
  5. When using the third party app link, Altrady's IP whitelist is automatically set on OKX, for greater security.





Step-5:


  1. Complete authentication as required.


Step-6: A window will appear with the newly created key, stating "1 API created successfully".


  1. Click on "Show Info".



  1. Copy the API key and Secret separately, using the copy button next to each one. These will be pasted into Altrady below.



Step-7:


  • In a different tab/window, go to Altrady and follow the steps below:


  1. Click on "Settings".
  2. Click on "Exchange Account API Keys".
  3. Click on "+Connect Account".




  1. Select **OKX **from the dropdown list.




Step-8:


  1. Ensure that "Manual Connect" is selected.
  2. Ensure that the API version matches the URL used to create the OKX API key (or choose Auto detect).
  3. Paste the previously copied API and Secret into their respective fields.
  4. Enter your passphrase into the respective field as well.
  5. Click Connect.




Check the url for the site where you have created your API key and select it from this list



Step-9: Altrady will sync the balances**. Click Connect.**




**Step-10: **Click Next





Step-11: Go back to OKX exchange and click Complete.



You should see the API key successfully created, in the API list in OKX.


Step-10:



  1. A new Trading Account should be visible in Altrady under Exchange Account API Keys, for the API key that was just connected.



  1. Edit the details anytime by clicking the Edit button, next to the Trading Account on the Exchange Account API Keys page.


If you need to replace your OKX API key, this should be done by editing the existing Trading Account with the details of the new API key * — not* by connecting it as a new Trading Account.


If your balance is not displayed immediately, refer to the following section: Syncing Balances. The video shows how to sync your exchange balance with Altrady


Non Third-Party (Manual API key)


Step-1: If the third party method isn't working or you prefer more control, you can use the manual method to create the API key.


  1. Login to your OKX account.



Step-2:


  1. Click on the "APIs" button
  2. Click on "Create APIs".



Step-3:


  1. Assign a name to the API key.
  2. Select the account to create an API key for. If you're creating an API key for a subaccount, select your subaccount here.
  3. Set the purpose to "API Trading".



Step-4:


  • In a different tab/window, go to Altrady and follow the steps below:


  1. Click on "Settings".
  2. Click on "Exchange Account API Keys".
  3. Click on "+Connect Account".




  1. Click on "OKX".



Step-5:


  1. Ensure that Manual Connect is selected.
  2. Click the copy icon next the the IP whitelist, ready to paste into OKX.




Step-6:


  1. Go back to OKX exchange.
  2. Enable the Trusted IP access and** Paste** the copied IP whitelist to the IP address field. All 20 of Altrady's IP addresses must be copied and pasted.
  3. Set "Trade" within the permissions.
  4. Create and enter a passphrase of your choice **(**take note of the passphrase as it will be required later). this is an additional security method required by OKX.
  5. Click "Submit All".




Step-7:


  1. Complete authentication as requried
  2. A new window will appear with the newly created key, stating "1 API created successfully". Click on "Show Info".



Step-8:


  1. Copy the API key and Secret separately, using the copy button next to each one.



  1. Go back to Altrady
  2. Ensure that the API version matches the URL used to create the OKX API key, e.g. my.okx.com or www.okx.com (or choose Auto detect)
  3. Paste the API and Secret into their respective fields.
  4. Enter your passphrase into the respective field as well**.**




  1. Go back to OKX exchange and click "Complete".



  1. You should see the API key successfully created, in the API list in OKX.



  1. Go back to Altrady, then click " Connect" at the bottom of the window.



Step-9:


  1. A new Trading Account should be visible in Altrady under Exchange Account API Keys, for the API key that was just connected.



  1. Edit the details anytime by clicking the Edit button, next to the Trading Account on the Exchange Account API Keys page.


If you need to replace your OKX API key, this should be done by editing the existing Trading Account with the details of the new API key * — not* by connecting it as a new Trading Account.


If your balance is not displayed immediately, refer to the following section: Syncing Balances. The video shows how to sync your exchange balance with Altrady



Syncing Balances


If balances have not yet updated from the exchange, the video below shows how to easily update them:



If you have questions, please feel free to chat with our customer support service linked at the bottom of this page.

Updated on: 18/06/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!