In order to use the same automation software, you need to make a few changes depending on the type of API you are using.
Typically, an API integration requires the following configuration items:
- API Keys. Your software communicates with Noones to access your data (e.g. update offers for price management, access to trading chats, etc.)
- Webhooks (optional). Your software can receive notifications of various events (for example, the start of trading, a new message in a trading chat) and respond to them.
There are currently 2 types of API keys available.
- HMAC - keys are configured in the Marketplace
- OAuth2 keys are in a separate Developers Portal interface.
In addition to accessing your own data, OAuth2 API keys allow your application to access other users's data and act on their behalf if they grant such access. HMAC and OAuth2 keys use different authentication algorithms, so check with your developer before proceeding with the configuration.
Note: Authentication is required to access all API methods. Please make sure you pass authorization headers even for methods like /currency/list or /offer/all which don't require user context.
HMAC API
API Access
-
Log in to your Noones account, hover over your username on the top right of the page and click Settings from the context menu that appears.
-
On the menu on the left side of the page, click Developer.
The Developer page appears.
-
Insert the two-factor code in the field below and click Add new API key.
Your new API key appears on the Developer page alongside with additional sections. Save the Key and Secret. They will be used later for API Authentication. -
Enable endpoints that are used by your software
-
Update your software configuration with the new API Key and Secret.
-
Change the base API URL: https://noones.com/api
Webhooks
-
Update your software configuration to support new Validation headers:
Header name
Description
X-Noones-Request-Challenge
Webhook address verification request
X-Noones-Signature
Webhook event notification
- Open the Developer page and scroll to the Webhooks section
- Paste the link of your public application endpoint into the Request URL field and click Save.
- In case of success, a list of events available for subscription appears below. Tick a box to select an event from the Subscribe to events list.
HMAC API Changes
- wallet/* methods are not available anymore. Please contact us if you have used any of these methods.
OAuth 2.0 API
Direct Access
- Authenticate in Developers Portal
- Navigate to the Direct Access Dashboard
- Start API Key creation wizard
- Enter a name for your key
- Make sure you've selected the Noones API product on the list and press "Create Key" button
- Find the new created API key in the list and copy its Key ID
- Click on the icon and enter your password
- After successful authentication you will be able to copy your API Key's Secret
Don't share your API Key Secret with anyone under any circumstances. -
Update your software configuration with the new credentials (API Key, API Secret) and the following endpoints:
Token endpoint https://auth.noones.com/oauth2/token API Gateway endpoint https://api.noones.com/
Delegated Access
- Authenticate in Developers Portal
- Navigate to the Delegated Access Dashboard
- Start Application creation wizard
- Enter a name for your Application and upload its Logo if required
-
Make sure you've added the following Products:
- Noones API
- Sign in with Noones
- Fill-in your Contact details
- On the last step enter the Callback URL where a user will be redirected to upon successful authentication and click on "Create App" button.
- Find the new created API Application in the list and copy its Key ID
- Click on the icon and enter your password
- After successful authentication you will be able to copy your App Secret
Don't share your API Key Secret with anyone under any circumstances. -
Update your software configuration with the new credentials (App Key, App Secret) and the following endpoints:
Authorization endpoint https://auth.noones.com/oauth2/authorize Token endpoint https://auth.noones.com/oauth2/token API Gateway endpoint https://api.noones.com/
Webhooks
-
Update your software configuration to support new Authentication headers:
Header name
Description
X-Noones-Request-Challenge
Webhook address verification request
- Authenticate in Developers Portal
- Navigate to the Direct Access Dashboard and scroll to the Webhooks section
- Click on the "Add Webhook" button
- Create a webhook by specifying its URL and choose the events you want
- Click on "Save" button.
OAuth2 API Changes
- wallet/* methods are not available anymore. Please contact us if you have used any of these methods.