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.

📘

Note:

If your country of residence is one of the supported countries for Wallets, you will also receive a virtual Wallet (demo) account. Once you complete the real account creation process, a real Wallet account will also be created, based on the currency you select.

Attention Developers – Wallet Accounts Can’t Trade!

If your account type is CRW (Wallet) or VRW (Virtual Wallet), you cannot perform trading transactions via API.
To continue using the API for trading operations (like buy, proposal, etc.), please follow these steps:
1️⃣ Create a real trading account (CR) on Traders Hub.
2️⃣ Use that CR account when generating your API token.

How to add or select your real trading (CR) account

To use the Deriv API for trading and earn markup commission, you must have a CR (real trading) account. Here’s how to check or create one:

Step 1

Open the account switcher

Click the dropdown next to your balance to view all available accounts.

Step 2

Manage your accounts

Tap "Add or manage account" to open or switch to a trading account (CR).

Step 3

Choose your currency

Select the "Fiat currencies" tab and pick your preferred currency to open a CR account.

Once created, your CR account (e.g. CR12345678) will be ready to use with API tokens for trading actions like buy, proposal, etc.

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.

Create 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.

   ❗️

   Important

   To use the API for trading operations (like buy, proposal, etc.), use your real trading account (CR).

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.