3. Trading: Configurations

The Configurations page defines market availability and all instrument/pair parameters used by pricing, margin checks, execution, and risk. It is the primary setup area for symbols in Crypto, Commodities, Forex, Stocks, Indices.

Who uses this: Admins and Risk Managers (edit); Traders and Read-only users (view).
Key actions: Add weekends/holidays, add time zones, add/edit symbols and pair parameters, import/export settings.

Finding the page

Left nav → Trading → Configurations.

You’ll see:

1. Settings by symbols group: group chips (Crypto, Commodities, Forex, Stocks, Indices) + Search.

2. Weekends panel with + Add weekend.

3. A toolbar on the right: Import, Export, + Add symbol, + Add timezone.

4. A table of trading pairs with status and parameters.

Group switcher & search

1. Group chips filter the table to a symbols family (e.g., Crypto).

2. Search… finds symbols/pairs and names within the current group.

Weekends

This block holds non-trading windows (regular weekends or recurring holidays). When a weekend rule applies, the platform does not stream ticks and does not accept orders for the target instruments.

1. Button: + Add weekend (opens the create dialog, see §3.1).

2. Weekend rules are evaluated in UTC at storage, but applied according to the pair’s Time zone (see §2.5 and §4) per the transcript.

Toolbar (right side)

1. Import: bulk upload of symbol/pair parameters (see §5).

2. Export: download current table as CSV/JSON for auditing or migration.

3. + Add symbol: create a new tradable pair entry (see §3.2).

4. + Add timezone: register a trading time zone selectable by symbols (see §3.3).

Trading pairs table

Columns include:

Dialogs and forms

Add weekend (non-trading rule)
Opens from + Add weekend.

Fields:

1. Timestamp: base date/time (UTC storage; UI presents local or selected TZ).
2. Repeat: week, month, or year (recurring weekend/holiday).
3. Work from / Work to: intraday window that is allowed to trade on the repeated date; outside of it, the market is closed.

Typical weekend rule: set a timestamp on the target weekend day, Repeat=week, and leave Work from/to empty to block the full day(s); or specify partial work hours for special sessions.

Validation & rules

1. The defined window applies to instruments in the current group or (if your instance supports targeting) to selected symbols/pairs.

2. Overlapping rules are permitted; the most restrictive outcome wins.

3. When a pair has its own Timezone, the engine evaluates the “closed” period in that TZ.

Add symbol (create trading pair)

Opens from + Add symbol.

Fields:

1. Symbol (select) – required (e.g., BTC/USDT).

2. Active (toggle) – enable trading.

3. Name – display name (e.g., “Bitcoin vs USDT”).

4. Swap long / Swap short – overnight fee long/short (pips).

5. Order calculation type – present in UI, do not use (per transcript).

6. Spread – bid/ask difference (pips).

7. Margin requirement (%) – collateral percent required.

8. Commission – per-order fee (pips).

9. Margin ratio – leverage; used in margin formula.

10. Lot volume (per symbol) – lot size is configured separately for each symbol. This makes it possible to calibrate trade volume efficiency across instruments. Use larger lots for Forex pairs or other low-volatility instruments so user trade quantities remain meaningful.

11. Timezone – select IANA TZ (affects weekends).

Validation:
Numeric fields must be non-negative; Margin ratio > 0; Lot volume > 0.
Keep Spread/Swap/Commission consistent with the pair’s minimum price step/precision.
Name 1–64 chars.

Save to add the pair to the table.

Edit symbol

Click ✏️ Edit in Actions. All fields as above are editable.
Changes apply immediately for pricing/margin checks.

Add timezone

Opens from + Add timezone.

Timezone: selectable list of IANA zones (e.g., Africa/Abidjan).

Usage: Once added, the time zone becomes available in the Timezone selector for symbols/pairs.

User configuration groups

Configuration groups bundle parameters such as swap, commission, and margin, and may apply either to specific pairs or to entire trading groups.

Groups can then be assigned directly to users. When a user belongs to multiple groups, the system applies the groups in the defined priority order.

This enables flexible business policies, such as:

1. Creating VIP groups with minimal commissions and enhanced leverage.

2. Assigning Watchlist groups with extremely high commissions or stricter margin settings for accounts suspected of cheating or arbitrage.

Groups are maintained and edited by Admins and Risk Managers. Traders and read-only users cannot change group assignments.

Margin logic 

Used by pre-trade checks to ensure account collateral is sufficient.

Formula:

lot — number of units/lots requested by the order.
price — current price of the instrument.
margin_ratio — leverage factor (e.g., 1000).

The platform then enforces Margin requirement (%) against this collateral.
If available balance is less than required, order creation is blocked.

Notes:

Commission and spread are accounted for by pricing/risk components.
Rounding follows Price precision and pair’s minimal step.

Import / Export

Import lets you bulk create/update pairs.

1. Format: CSV or JSON (project-standard schema).

2. Mode: Validate only (dry run) or Upsert (create new + update existing).

3. CSV replace behavior: trading configurations for symbols can now be imported and exported in CSV format. If a configuration already exists for a symbol, the imported row will replace the existing configuration. This simplifies migration and setup processes.

4. Mapping: Source columns → fields (Symbol, Active, Name, Swap long, Swap short, Spread, Margin requirement, Commission, Margin ratio, Lot volume, Timezone, optional Price precision).

5. Report: A per-row success/error log after the run.

Export downloads the current, filtered table (CSV/JSON) including audit timestamps (Created at, Updated at). Useful for versioning and reviews.

Operational notes & best practices 

1. Do not document or rely on “Order calculation type”—it’s a placeholder.

2. Spread and Swap are configured in pips; ensure Price precision matches your minimum step so UI and risk math align.

3. Lot volume calibrates user-visible quantities to meaningful exposure (e.g., FX often defines 1 lot = 100,000; in crypto/equities, use pair-specific units).

4. Timezone at pair level controls how the weekend/holiday rules apply for that instrument (U.S. equities vs. crypto, etc.).

5. If you need to simulate market shapes for testing, use Price deltas (separate page) in short intervals to create stepwise up/down patterns; Configurations simply defines the baseline parameters and trading calendar.

Audit & security

Every create/update/delete in Configurations is written to the audit log with user, timestamp, and before/after values (reflected by Created at / Updated at columns).
Only users with Admin/Risk Manager roles can change pair parameters and weekends; others are read-only.

Glossary

1. Pip (Point) — minimal price increment used for spreads, swaps, commissions.

2. Spread — Ask − Bid, quoted in pips.

3. Swap — overnight fee for carrying positions to the next session.

4. Margin requirement (%) — minimum collateral percent that must be free to open a trade.

5. Margin ratio (Leverage) — factor controlling exposure vs. collateral.

6. Lot volume — base unit size for quantity on the pair.

7. Price precision — number of decimals used for price display and rounding.

8. Weekend/Holiday rule — non-trading window; blocks ticks and order intake for targets.