Step-by-step guide: Retrieve your API Key from OKX

Note: VEMA support will never ask for your API keys. These give access to your account and should never be shared outside of the VEMA Trader API key screen.

 

 

Step 1  - Login

Login to your OKX account. If you do not have a login, click here to create an OKX account.

 

Step 2 - Create a Sub-account (Skip this step if you already have a VEMA dedicated OKX sub-account)

A) Click on your Account icon in the upper right of the screen (yours may or may not have an email/phone number next to it) and click 'Sub account' from the dropdown menu 

B) Click + Create Sub Account on the right side of the page to create your sub-account.

C) Enter a new login, password, set the Account Type to Standard Sub-Account, then click Submit All. These details will be used to login into your sub-account, fund your account and trade.

D) Review your sub-account details are correct by going back to the Sub account tab on the profile dropdown to review the account details. Here you can view the status and manage your sub-account.

 

Step 3 - Logging into your sub-account & ensuring the correct account mode and position mode.

 

Enable Sub-account switching
Login to OKX, in the top-right mouse over the profile icon and choose Sub-account

 

Then mouse over Action, and turn on Enable Account Switching


Now when you mouse-over the profile icon again, you'll be able to click Switch Account, and login to the subaccount

 

 

The next step is changing account mode and position mode.

There's two ways to do this

1. Along the the top, choose Trade --> Futures

In the top-right, click the settings icon

 

In the pop-out panel, you'll be able to change the Account mode and Position mode.

Change Account Mode to Single Currency Margin.

 

Change Position mode to One-way Mode

 

2. Alternatively, you can ensure your account mode is set to single-currency-margin,  multiple-currency-margin, or portfolio-margin. 

To do so, navigate to the subaccount page again by clicking on your account icon in the upper right of the screen (yours may or may not have an email/phone number next to it) and click 'Sub account' from the dropdown menu 

Check the account mode of your new sub-account.

 

If account mode is simple, on the right hand side of the screen click Action > Trading Settings > Account Mode and change to one of the above, then click "Save".

 

If you receive an error here saying "setting must be changed by logging in to the subaccount" then follow the beginning of step 3.

 

Note: Some users have recently found they cannot switch their sub-account type to single currency margin if their main account mode is still set to simple. If you're having issues, try following this step on your main account then repeating on your sub-account.

 

Step 4 - Fund your sub-account

Ensure that your OKX trading sub-account has collateral. OKX subaccounts contain both a "Funding" and "Trading" account, and by default funds are placed in the funding account, but API keys connect to the trading account.

 

To do this, on the sub-account page click "transfer" on the relevant sub-account

 

Then make sure to set the "From" field to "Funding account" and the "To" field to "Trading account"

Then transfer your desired funds.

You can also navigate to this page by clicking in the navigation bar 'Assets' > 'My Assets' and under the 'Overview' section, you should have a percentage value greater than 0% next to your trading account as shown below.

To transfer from "Funding" to "Trading" accounts use the "Transfer" button.

 

 

 

Step 5 - Create  your API Key

In the account menu navigate to ‘API’.

 

Step 6

On this page, use the dropdown menu to select the sub-account you wish to link with VEMA.

We strongly recommend you do not use your Main Account and instead use a sub-account solely for trading with VEMA.

If you don't have an OKX sub-account, follow step 2 to create an OKX sub-account.

 

Step 7

On the left click “Create API Key”. 

 

Step 8

Enter an API Name and passphrase. During this setup, please note:

• Record the passphrase in a safe place, it is a new unique password that you create for the API key only. This would be used later to integrate with VEMA Trader.
• Do NOT add an IP address on API key creation as VEMA currently does not support this feature.
• Do NOT share this information with anyone.

 

Step 9

Select key permission ‘Trade’. Do not click ‘Withdraw’ if it is visible (VEMA will reject the API key if you do).

 

Step 10

Enter the email code and 2FA code. You can get this from your 2FA application which you set up when creating an OKX account.

 

Step 11

Once done, click ‘Confirm’ and the following popup will appear. Take a copy of this information for your integration with VEMA Trader. Do NOT share this information with anyone.

 

Step 12 - Add to VEMA

Now return to https://app.vematrader.com/login and log into your VEMA Trader account.

Head to your profile settings and click "My account"

 

Then select API Keys.

Now copy and paste the API key, API Secret and Passphrase into VEMA Traders “API key”, "Passphrase" and “API Secret” fields and click "+Add Key"

 

Step 13

Your API key will now appear on screen. You’re now able to trade on OKX through VEMATrader. Happy trading!

 

NOTE

If you experience any issues during this process, please don’t hesitate to contact us at support@vematrader.com or submit a support ticket here.