Account setup

Create a Deriv account

1. Visit api.deriv.com
2. Click Sign Up on the top right corner of the page.
3. Provide your Email Address.
4. Check your inbox for a verification email and click the link to confirm your account.
5. After verifying your email, provide your Country of residence, Citizenship, and create a Password.
6. Your Demo account is now active — you can start building and testing your apps right away.
7. To create a Real account, click Complete my profile.
8. Choose your Account Currency, fill in your Personal and Address details, and accept the Terms of use to proceed.
9. Your Real account is now active — you’re eligible to earn markup commissions on your app.

Register your Deriv application

First-time app registration

1. Open the Dashboard which will take you directly to the Register application screen.

To create additional apps

1. Open the Dashboard and go to the Applications tab.
2. Click Register new application to create a new app.

---

Register a new application

1. Provide a name for your application and accept the Terms and conditions.

2. Configure your application:

   1. Add your markup fee percentage.

      📘

      Note

      Markup is the commission added to the trade price to earn additional income.
      Learn more about markup calculation here.

   2. Fill in your OAuth details:

      1. Redirect URL – Allows users to log in to your app using their Deriv accounts without using an API token.
      2. Verification URL – Used for email verification. If provided, a link with a verification token will be sent to the user’s email. Otherwise, the Redirect URL is used.
         Example: If your domain is https://example.com and your verification endpoint is /verify, the full URL would be:
         https://example.com/verify
      3. Select the required Scopes of authorization and click Create.

Your app will now appear in the Application Manager under the Applications tab.

---

To update an existing app

1. Open the Dashboard and go to the Applications tab.

2. Click the pencil icon next to the app you want to edit.

   

3. You can update the App name, Markup fee percentage, and OAuth details as needed.

Generate an API token

1. Open the Dashboard and go to the API tokens tab.

2. Click Create new token from the left panel.

3. Select the account type for which you want to generate a token.

4. Choose the required access level (scopes):

   1. Read – View market data and account information.

   2. Trade – Full access to trade, manage funds, and sensitive data.

   3. Payments – Enables withdrawals to payment agents and inter-account transfers.

   4. Trading Information – View trading history.

   5. Admin – Full access to account settings, token usage, and account management.

      ❗️

      Not recommended

      The Admin scope gives extensive access to all account functions and should only be used when absolutely necessary. Make sure the token is stored and used securely.

5. Enter a descriptive name for your token.

6. Click Create token to generate the token.

7. A confirmation pop-up will appear — “Token created successfully.”
   Make sure to copy and save the token key now.

⚠️

Important

For security reasons, the token cannot be viewed or copied again.
If you lose the token, you’ll need to create a new one.