Setting up a Deriv application
For the reviewer, Links in this section will be provided in the future.
Deriv account
If you don't have a Deriv account yet, you can easily create one by visiting our signup page or using the new_account_virtual API call. It's completely free. And if you have an account already, please log in using your account details. To avoid any accidental loss of funds during testing, we recommend using your demo account instead of a real account.
To earn markup, get a Deriv real account to receive your monthly earnings. You can also create a real account using new_account_real or new_account_maltainvest API calls.
To create Deriv applications, you'll need an API token with the Admin scope for the account you wish to use for your application.
How to create a Deriv API token
To create your API token, simply go to the Dashboard and select the Manage Tokens tab. From there, create a new token that matches the access level needed for your application's features.
To create a new API token, follow these steps:
- Select the scopes you need.
- Provide a name for your token
- Click Create
Alternatively, you can create an API token via the api_token API call.
You need a token with the Admin scope to create an application.
How to create a Deriv application
To create your application with the appropriate configuration options, select the Register Application tab in the Dashboard. You can make changes to your application's configuration at anytime in the Manage Applications tab.
| App information field | Description |
|---|---|
| Account | The account you want to create the application with |
| API Token | The API token you want to create the application with |
| App Name | Application name |
| Markup | The commission added to the trade price to earn additional income |
| Authorisation URL | The URL that enables clients to log in to your app using their Deriv accounts without an API token |
| Verification URL | The OAuth redirect URL for the OAuth authorisation |
To create an application, follow these steps:
- Select the account you want to create the application with.
- Select the API token added to your account ( it must have the `Admin` scope ).
- Provide a name for your application.
- Fill the Markup and OAuth details fields.
- Select the Authorisation Scopes needed by your application.
- Click Register Application.
Make sure the Authorisation and Verification URLs are correct based on your implementation.
For example, if your domain is https://example.com and your authorisation and authentication are handled by verfiy, your URLs will be:
https://example.com/verify