Please view our API documentation at: https://docs.onetrading.com/
To manage your API keys, head to Accounts>Choose an account>API tab on the right.
Creating an API key
To set up an API key, please follow these steps:
Log in to One Trading
Click on your User Icon
Select API
Click on New API key
Choose a name for your API key
Select if your API key will have either the Read, Trade, or Withdraw permission, or any combination thereof
You can use IP restrictions for up to five ipv4/ipv6 addresses (Optional)
Click on Create API key
If you have two-factor authentication (2FA) activated, enter the six-digit 2FA code and click on Authorise now
You will now receive a confirmation email
Click on the confirmation link in the email we just sent you. For security reasons, the confirmation link will expire after 30 minutes
You will now be redirected to the One Trading, and you will be shown a pop-up window with your API key
Note: Please be aware that this is the one and only time when you have the chance to see, save and back up the key.
Tip: To confirm your API key, make sure that you are always using the link from the most recent One Trading email you received and that the link has not timed out.
Permissions
One Trading provides Read, Trade, and Withdraw key permissions when creating API keys. For all details on permissions, please read our official API documentation.
Read
The Read permission includes all GET endpoints. It allows the key to read data (i.e. account balances, market prices, order and transaction history).
Trade
The Trade permission allows the API key to place or cancel orders. This includes POST and DELETE order endpoints.
Withdraw
The Withdraw scope allows you to deposit and withdraw funds from your account to your off-site wallets.
Additional permissions
Additional API key permissions may be added at a later date.
Deleting an API key
If you want to delete your API key, please follow these steps:
Log in to One Trading
Click on Accounts>Choose an account>API tab on the right
Select API
Click on Delete on the right side of the respective API key
Confirm the deletion by clicking on Yes, delete it in the pop up
Note: Once deleted, an API key can not be retrieved.
Troubleshooting
API Issues
If you experience any problems with the API, please contact us. Please note that requests regarding the API might take longer to provide a solution for compared to standard requests.
Lost One Trading API key
If you have lost your One Trading API key, then you may delete the key and create a new one as long as you still have access to your account. When creating the new API key, please keep it in a secure location so that only you have access to it and you don’t lose it.
Note: For security reasons, One Trading will never tell you what your API key is. Therefore please keep your API keys safely secured and accessible to you at all times.
Tip: Sending too many requests in a short period will result in blocked requests with HTTP status 429. The current limit is 240 requests per minute.
If you would like to delve deeper into the world of APIs and explore further information on this topic, we have a comprehensive resource available for you.
