The new Deriv API essentials

Here is everything you need to know about the new features, the technical upgrades, and how these changes benefit both seasoned developers and non-technical partners.

The landscape for developers and partners at Deriv is undergoing a massive transformation. The transition from Legacy Deriv API to the New Deriv APIs is here, and it’s a shift toward AI integration, enhanced security, and a "no-code" future.

Quick summary

• Key benefit: you don't need to be a coder to build trading tools. With new AI integration tools like ChatGPT, Claude, and Cursor can write your trading scripts and bots using plain English prompts.
• The platform: Deriv is the premier AI-friendly broker. Whether you are a seasoned developer or a beginner, you can build custom trading solutions and Expert Advisors by simply describing your strategy.
• The approach: this shift focuses on technical empowerment. By utilizing Deriv's new documentation structure and our AI assistant Amy, partners can educate their audience on how to go from a strategy idea to a functional app in minutes.
• The advantage: generate Markup commissions. Use the AI-ready context provided in the new portal to automate your workflow and scale your partnership potential earnings.

Legacy vs. new: what has changed?

The most important takeaway for existing users is the change in terminology. Legacy Deriv APIs and the New Deriv APIs.

‍

AI-Powered development: coding in natural language

One of the most exciting additions to the New Deriv APIs is the integration of AI tools designed to slash development time.

• MCP server (Model Context Protocol): Developers can now add the Deriv MCP server to IDEs like Cursor, Visual Studio, Google antigravity. Instead of manually digging through docs, you can simply ask the AI in natural language: "Please add a script for buying a contract," and the IDE will automatically generate the code and parameters.
• LLMS.txt: Deriv now provides a context file (LLMS.txt) that you can feed into ChatGPT, Claude or other LLMs. This gives the AI the full context of Deriv’s documentation, allowing it to write clean, well-structured Python code, Go, or C++ snippets for your specific trading needs.

‍

• Meet Amy: Amy is Deriv’s AI assistant. Within this portal, she serves as a specialised technical resource, providing instant, developer-focused support for your integration needs. Available in multiple languages (Spanish, Portuguese, Arabic, etc.), Amy can answer technical questions and provide code snippets directly within the ecosystem.

‍

Understanding commissions: markup vs. Deriv partnership programme

A common point of confusion for partners is how they can earn money through third-party apps. The logic remains clear:

• Markup Commissions: Earned when a user trades directly on your third-party app. You can set this between 0% and 3%
• Partner commissions (E.g. Revenue Share/Turnover): Earned when a user you referred trades on Deriv’s official platforms (Deriv Trader, Deriv Bot, DerivGo and SmartTrader).

For a limited time Deriv is offering up to 5% markup commission on the New Deriv APIs to encourage adoption and reward early movers.

Seamless user migration

To ensure a smooth transition, Deriv has implemented an intelligent lookup system. If a developer uses a New Deriv API app:

1. Existing users: Automatically redirected to the legacy environment they are familiar with.
2. New Signups: Automatically onboarded onto the New ecosystem.
   This helps ensure that your marketing campaigns work for everyone, regardless of when they joined Deriv.

Improved API explorer and workflows

The documentation has been completely overhauled with a focus on Workflows. Instead of just listing commands, the new docs guide you through the entire trading flow:

• Fetching symbols and subscribing to ticks.
• Authenticating via Personal Access Tokens (PAT) or OAuth 2.0.
• Handling error codes (401, 403) with built-in troubleshooting guides.
• Distinguishing between Public, Demo, and Real endpoints to ensure data security.

Coming soon: A new analytics dashboard

A new analytics dashboard will go live, including information about the apps and markup commission. 

How do existing partners transition to the new Deriv API?

If you are currently running an app on the Legacy API, action is required to avoid service interruption. This move is an infrastructure shift toward the OAuth 2.0 standard. 

Developers need to create a new app. The architecture, API calls, and authentication are completely different, so nothing from the legacy APIs carries over to the new Deriv APIs. To keep your app functional, you must audit your code for these three specific shifts:

• The death of loginid: You no longer need to pass a loginid in every request. The system now identifies the account via the specific Token used.
• Field renaming: Several parameters have been standardised. For instance, symbol is now consistently underlying_symbol across most endpoints.
• Strict validation: The New API is less "forgiving" of malformed data but more consistent. If a field is marked as required in the https://developers.deriv.com/docs/, your app must send it.

Action item: Review the full list of deprecated fields and logic changes at the Legacy API Page.

For existing partners: It is a one-time "housekeeping" task that enhances security and unlocks faster speeds for your users.

For new partners: The new Deriv API is a professional-grade engine that allows you to launch a global trading business with minimal overhead.

Ready to build? Explore the new Deriv API, secure your App ID and begin your integration on the Developer Dashboard today.

FAQs

Why am I being redirected to trading account instead of developer dashboard?

If you're being redirected when accessing developers.deriv.com, it may be due to using a legacy API account. Please sign up with a new email address to create your developer account. For best results, log out of all Deriv accounts before trying again.

How do I get my App ID? 

You can create your App ID by visiting developers.deriv.com. Once logged in, you’ll be able to register your application and generate your App ID. For more details, please refer to: https://developers.deriv.com/docs/

How do I get an API Token? 

You can create and manage your API tokens by logging in at developers.deriv.com. Once logged in, navigate to the token management section to generate a new token. For more details, please refer to: https://developers.deriv.com/docs/