Actions34
- Account Actions
- Confirmation Actions
- Market Actions
- Order Actions
- Position Actions
- Session Actions
- Watchlist Actions
Account → Set Preferences
AI-generatedSummary
Update the active Capital.com account’s preferences, changing hedging mode, leverage settings, or both.
Inputs
- Hedging Mode — Choose Disabled or Enabled to set hedging mode, or No Change to leave it unchanged (the default).
- Leverages (JSON) — Optional JSON object mapping asset classes to leverage values, for example {"CURRENCIES":20}. Leave empty to leave leverage settings unchanged; invalid JSON or a non-object value causes an error.
Output shape
A single record containing the Capital.com API response to the preferences update.
Sends a PUT request with only the supplied preference changes; if both inputs are left unchanged, it sends an empty body. API errors are returned as node errors.