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
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 and select the account type you desire to register your sub-account. 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
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.
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.
Change it to Single Currency Margin.
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.
If you were able to change the AccountMode above, then skip straight on to Step 4 - Fund 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’.
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.
On the left click “Create API Key”.
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.
Select key permission ‘Trade’. Do not click ‘Withdraw’ if it is visible (VEMA will reject the API key if you do).
Enter the email code and 2FA code. You can get this from your 2FA application which you set up when creating an OKX account.
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 log into your VEMA Trader and copy and paste the API key, API Secret and Passphrase into VEMA Traders “API key”, "Passphrase" and “API Secret” fields during the onboarding step or in the API key section under your profile settings and click “+ Add Key”
Your API key will now appear on screen. You’re now able to trade on OKX through VEMATrader. Happy trading!