Legacy vs New API
Comprehensive guides comparing Deriv Legacy API and New API endpoint by endpoint.
Before you start
- Review the breaking changes for each endpoint you use
- Test your integration in a development environment first
- Update your code to use the new field names and parameters
- Plan your development approach for the New API version
Data Endpoints
Active symbols
6 ChangesRetrieves all currently active trading symbols. Response fields renamed and filtering options removed.
Contracts for
5 ChangesGet available contracts for a symbol. Currency parameter removed, market data fields removed, and contract metadata simplified.
Ticks
4 ChangesSubscribe to real-time tick stream. Required response fields changed and subscribe parameter extended.
Ticks history
6 ChangesGet historical tick data. Required response fields changed, validation relaxed, and new parameter options added.
Account Endpoints
Balance
4 ChangesGet current account balance with real-time updates. Multi-account support removed in v4.
Portfolio
3 ChangesGet current portfolio. Symbol field renamed, loginid parameter removed, and app_id can no longer be null.
Profit table
5 ChangesGet profit/loss history. The loginid parameter removed, response fields now required, and app_id no longer nullable.
Statement
7 ChangesGet account statement. The loginid parameter removed, transfer-related fields removed, and action_type validation relaxed.
Transaction
7 ChangesSubscribe to transaction notifications. Multiple fields removed, symbol renamed, and action enum validation removed.
Trading Endpoints
Buy
3 ChangesPurchase contracts. The loginid parameter removed, buy field validation relaxed, and buy object now required in response.
Cancel
3 ChangesCancel an active contract. The loginid parameter removed, cancel object now required in response, and all response fields now required.
Contract update
3 ChangesUpdate contract parameters like take profit and stop loss. The loginid parameter removed, response object now required, and new display_order_amount field added.
Contract update history
3 ChangesGet contract update history. The loginid parameter removed, response field now required, and array items have required fields.
Proposal
10 ChangesGet contract pricing. Symbol renamed to underlying_symbol, multiple parameters removed, response proposal now required with only id guaranteed, field types changed.
Proposal open contract
8 ChangesGet open contract details. The loginid parameter removed, numeric field types changed to string | number, and deprecated display fields removed.
Sell
4 ChangesSell an active contract. The loginid parameter removed, price validation added, and sell response object with all fields now required.
Subscription Endpoints
Comparison Tips
Field name changes
Removed features
Simplified responses
Test thoroughly
Any other questions? Get in touch