Skip to main content

Dividends Adjustment

This section allows brokers to process dividend payments for traders holding open CFD positions. Brokers can apply dividends either to a specific trade server or, if operating multiple servers, to all orders across multiple trade servers. Traders can also be notified about dividend payments through push notifications in instant messaging apps.

Navigate to Dealing Operations > Dividends Adjustment in the left-side menu.


โš ๏ธ Before proceeding make sure you selected the desired symbol groups to be applicable for the operation in the Dealing desk - Dealing settings section

โš ๏ธ To choose which fields are available for configuration, go to Dealing Operations โ†’ Settings and enable the desired fields along with their threshold values.


Dividends Adjustment for a Single Symbolโ€‹

  1. Select the date and click Dividends Adjustment.
  2. Fill in the required data in the window that appears. Scroll down to view all available parameters.
  3. The description of all parameters is provided in the table below.

Parameter Descriptionsโ€‹

ParameterDescription
ServerSelect the server where the dividend operation should be executed.
Dividends from CSVTurn this switch ON if you are uploading a CSV file. See the CSV upload process below for details.
SymbolChoose the symbol.
Collect Symbol SuffixesTurn ON to group symbols with suffixes (e.g., EURUSDc, EURUSDd, EURUSDcents) under the main symbol (EURUSD). Turn OFF to display them separately.
Long DividendsCan be positive or negative: Positive values mean dividends are accrued, negative values mean dividends are deducted, and 0 means no accrual.
Short DividendsWorks the same way as Long Dividends, but applies to short positions.
Long Tax %The tax percentage applied to the accrued dividends. If dividends are 0, tax will also be 0.
Short Tax %The tax percentage applied to the accrued dividends for short positions.
DelayedTurn ON to schedule the dividend operation for a future date/time. If OFF, the operation will be executed immediately.
Applied DateSelect the time and date for the operation and enter any relevant comments. โš ๏ธ Dividends can only be accrued when the trading session for the instrument is closed.
Dividends Deal CommentBy default, the system fills this field as "Div.Adjustment for #SYMBOL", e.g., Div.Adjustment for AUDUSD. You can customize it using the format "#SYMBOL_dividend position #POSITION_ID".
Use Conversion RatesTurn ON if you need to apply a custom conversion rate instead of the actual market rate. Select currencies and enter the desired rate.
Check MarginIf ON, the system checks if the dividend accrual will result in a stop-out. If OFF, the operation proceeds without verification.

โš ๏ธ If any errors or incorrect data are present, the "Preview and Schedule" button will be inactive.

Final Steps:โ€‹

  1. Review all entered data carefully.
  2. Click "Preview and Schedule" to see a summary with preliminary calculations.
  3. If everything is correct, click "Schedule Job" to finalize the process.
  4. The dividend task will now appear in the calendar, where you can edit or cancel it at any time.

Uploading Dividends via CSV Fileโ€‹

  1. Navigate to Dealing Operations > Dividends Adjustment in the left-side menu.
  2. Choose one or multiple servers.
  3. Turn ON the "Dividends from CSV" switch.
  4. Click "Show the format details" to see the CSV template.
  5. Ensure the trading session for the instrument is closed before proceeding.
  6. Prepare your CSV file according to the below provided template.

โš ๏ธ Note: If you re-upload tasks from the same file (for example, after making changes and wanting to update the scheduler), duplicate tasks โ€” identified by matching time and instrument โ€” will be canceled and marked as "Canceled" in the system.

๐Ÿงพ Column Definitionsโ€‹

ColumnTypeExample
SymbolstringAAPL
Collect Symbol Suffixesnumber (0 or 1)1
Long Dividendsnumber1.85
Short Dividendsnumber-1.85
Delayednumber (1 only)1
Applied Date (UTC)DD.MM.YYYY HH:mm31.01.2025 23:10
Check Marginnumber (0 or 1)0

๐Ÿ“‚ Example File: Example.csvโ€‹

Symbol;Collect Symbol Suffixes;Long Dividends;Short Dividends;Delayed;Applied Date;Check Margin
AAPL.US;1;1.85;-1.85;1;31.01.2025 23:10:00;0
EURUSD;1;15.64;-10;0;31.01.2025;0
  1. Upload the file.

Required CSV Parametersโ€‹

ParameterDescription
SymbolSymbol name.
Collect Symbol SuffixesON - Upload all suffix variants. OFF - Group all symbol suffixes.
Long DividendsCan be positive or negative: Positive values accrue dividends, negative values deduct dividends, and 0 means no accrual.
Short DividendsWorks the same way as Long Dividends, but applies to short positions.
DelayedDefault = ON (delayed operation).
Applied DateSet the non-trading time (date/time format). Future dates will appear as scheduled tasks in the calendar.
Check MarginON - The system checks for stop-outs before processing. OFF - The accrual proceeds without verification.

Uploading the File:โ€‹

  1. Click "Choose File" to upload your CSV.
  2. The system will validate the file and display the results in a preview window.
  3. Status indicators:
    • โœ… Green dot: No errors detected.
    • โŒ Red dot: Errors found. Hover over the dot to see the error details.
  4. The file will only be uploaded if it contains no errors.

Permissionsโ€‹

Required Permissions for Dividend Adjustmentsโ€‹

MT4MT5
Access Rights: Accountant (deposit/credit/withdraw money) Access Rights: Accountant (balance operations)
Operations: Trading Transactions โ†’ Dealer, Trading Transactions โ†’ Edit/Delete TradesOperations: Dealing โ†’ Dealer