What is the correct format for excluded symbols?

Symbol Exclusion List — Formatting Requirements

For the Symbol Exclusion List to function correctly, entries must follow the exact exchange-defined symbol format and the required configuration structure.

Incorrect formatting will cause the exclusion to fail silently — meaning the symbol may still initialize and trade.

1️⃣ Use Exact Exchange Symbol Names

Always use the precise symbol identifier as defined by your exchange.

Examples:

  • ✅ USDCUSDT
  • ✅ RLUSDUSDT
  • ❌ USDC/USDT
  • ❌ usdcusdt
  • ❌ UsdcUsdt

Even minor differences — such as slashes, spacing, or altered capitalization — will prevent proper matching.

2️⃣ Symbols Are Case-Sensitive

Symbol names must match the exchange format exactly, including capitalization.

  • BTCUSDT → Valid
  • btcusdt → Invalid
  • BtcUsdt → Invalid

The bot performs an exact string comparison against the exchange API response. Any case mismatch will result in the symbol not being excluded.

3️⃣ One Symbol Per Line

Each symbol must be listed individually under the ExcludedSymbols configuration section.

Correct structure:

ExcludedSymbols:
  - "USDCUSDT"
  - "RLUSDUSDT"

Do not:

  • Combine multiple symbols on one line
  • Remove required quotation marks (if your configuration enforces them)
  • Alter indentation structure in YAML format

4️⃣ Why Proper Formatting Is Critical

The exclusion list acts as a hard filter during symbol initialization. If formatting is incorrect:

  • The bot may still initialize the symbol
  • Trades may continue unexpectedly
  • DCA sequences may still activate
  • Risk controls may not behave as intended

Because the system does not partially match symbols, precision is mandatory for reliable filtering.

5️⃣ Pre-Save Verification Checklist

Before saving your configuration, confirm:

  • ✅ Symbol name matches the exchange exactly
  • ✅ Capitalization is correct
  • ✅ One symbol per line
  • ✅ Proper YAML indentation under ExcludedSymbols

📌 Key Takeaway

The Symbol Exclusion List works only when entries are written exactly as defined by the exchange, with correct case sensitivity and proper YAML structure.

Precision in formatting guarantees reliable enforcement of your trading restrictions.

📎 Related Topics