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, 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’.
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 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"
Your API key will now appear on screen. You’re now able to trade on OKX through VEMATrader. Happy trading!