deriv-com/deriv

Add or fix New Deriv API authentication — OAuth, tokens, accounts, and trading WebSocket sessions. Use whenever a task involves Deriv login, sign-up, OAuth with PKCE, personal access tokens, OTP, tokens, scopes, sessions, accounts, account switching, logout, reconnects, or obtaining a trading WebSocket — even if the user just says "users can't log in", "hook up Deriv OAuth", "get an authenticated socket", or "reconnecting loses the session". Not for Legacy API compatibility.

Add TradingView's Lightweight Charts (the lightweight-charts npm package, Apache-2.0, ~60 KB) as the slim price chart of an application built on the New Deriv API Options platform, fed from the app's shared WebSocket and overlaid with barriers and trade markers derived from its trading state. Use whenever a task mentions Lightweight Charts, a TradingView chart, a small or minimal chart, a candlestick or tick chart without SmartCharts, or "add a chart" to an app that names no library (this is the default chart) — even if the user just says "show the price", "a simple chart is enough", or "draw the result on the chart". Not for a second WebSocket, for Legacy API compatibility, or for the full SmartCharts terminal (read the chart selection guide first).

Bundled Deriv API docs snapshot for when hosted MCP tools are unavailable. Use when looking up Deriv API endpoints, authentication, errors, workflows, contract types, or field lists from the bundled docs; when the hosted MCP is down; or when the user asks for llms.txt / endpoint pages. Prefer hosted get_schema, get_field, and guide tools while they work. Do not invent fields.

Add New Deriv API market discovery and live prices — active symbols, contracts for a symbol, ticks, and tick history. Use whenever a task involves market or symbol selectors, deciding which trade types a symbol supports, deriving trade controls from contract metadata, live tick or price subscriptions, charts, or public read-only feeds — even if the user just says "show live prices", "list the volatility indices", or "why is this duration rejected". Not for order execution or Legacy API compatibility.

Add the Deriv SmartCharts price chart (the @deriv-com/smartcharts-champion package) to an application that uses the New Deriv API Options platform, and drive its barriers and contract markers from the app's trading state. Use when the chart selection guide escalates to SmartCharts or the user names it — a terminal-grade chart with built-in technical indicators, drawing tools, an in-chart symbol browser, or Deriv's standard contract markers and barriers without building an overlay layer — even if the user just says "the same chart Deriv uses", "a full trading terminal", "draw the barrier on the chart", or "mark my trades on the chart". A chart request that names no library defaults to Lightweight Charts; read the guide first. Not for a second WebSocket, for Legacy API compatibility, or for non-Deriv charting libraries.

Implement the New Deriv API Options flow: price, buy, monitor, sell, and settle. Use whenever a task prices or purchases a contract, tracks open or closed positions, reconciles a portfolio, sells early, cancels a contract, sets take profit, handles buy or sell errors, recovers mid-trade from a disconnect, or cleans up subscriptions — even if the user just says "the buy button fails", "show my open trades", or "sell at market". Not for Legacy API compatibility or OAuth setup alone.

Map trade names to New Deriv API Options contract families, proposal shapes, and live availability. Use whenever a task selects, adds, or configures a Deriv Options trade type — Accumulator options, Rise/Fall, Higher/Lower, Matches/Differs, Even/Odd, Over/Under, Multipliers, Touch/No Touch, Stays Between / Goes Outside, Vanilla options, Turbo options, Asian options, Reset Call / Reset Put, or High/Low Ticks — even if the user just says "up/down", "digits", "binary call/put", or "add accumulators to my bot" without naming contract codes. Not for Legacy API compatibility or CFD execution.

Build or extend an authenticated trading application on the New Deriv API Options platform. Use whenever a task involves creating or extending a Deriv-powered trading product in any form — an app, template, terminal, bot, or trade screen; adding or combining trade types in one product; or wiring login, live prices, and purchase together — even if the user just says "build me a trading app", "add trading to my site", or names trade families like Accumulator options and Rise/Fall together. Not for Legacy API compatibility or general explanations of financial derivatives.