Skip to content

E_SYM_001 — Symbol is not registered

A request referenced a symbol name (e.g. "BTCUSDT") that the engine's SymbolRegistry has never seen. FLOX requires every symbol to be registered up-front so that strategies, indicators, and replay sources can map names to compact uint32_t IDs at hot-path latency.

Where it fires

  • Engine.run_csv() and Engine.run_ohlcv() when a symbol referenced in the input doesn't appear in add_symbol() calls.
  • SignalBuilder.market_buy(symbol="…") and similar emitters.
  • Any C-API path that accepts a const char* symbol (e.g. flox_registry_get_symbol_id).

How to fix

Register the symbol before running the engine or constructing signals.

import flox

eng = flox.Engine()
eng.add_symbol("BTCUSDT")           # ← register first
eng.run_csv("BTCUSDT", "btc.csv")   # ← then reference it

const flox = require("@flox-foundation/flox");
const eng = new flox.Engine();
eng.addSymbol("BTCUSDT");

FloxRegistryHandle reg = flox_registry_create();
flox_registry_add_symbol(reg, "exchange", "BTCUSDT", /*tick_size=*/0.01);

Common causes

  • Typos between add_symbol() and the symbol referenced later. FLOX is case-sensitive; "BTCUSDT" and "btcusdt" are different symbols.
  • Forgetting to register a symbol that appears in the dataset but isn't part of the strategy's declared universe — register every symbol you intend to read from, even if you won't trade it.
  • Loading data before registering — for stream / replay paths that need the symbol ID immediately.

Diagnosing

The FloxError exception carries the offending symbol name in its message field. Print the registered set to compare:

try:
    eng.run_csv("BTCUSDT", "btc.csv")
except flox.FloxError as e:
    print(f"{e.code}: {e.message}")
    print(f"registered: {sorted(eng.symbols())}")