OpenBB-finance/OpenBB · error · ValueError

Invalid symbol format '{sym}'. Expected 'dataflow::identifie

Error message

Invalid symbol format '{sym}'. Expected 'dataflow::identifier'. Use `available_indicators()` or `list_tables()` to find valid symbols.

What it means

Error "Invalid symbol format '{sym}'. Expected 'dataflow::identifier'. Use `available_indicators()` or `list_tables()` to find valid symbols." thrown in OpenBB-finance/OpenBB.

Source

Thrown at openbb_platform/providers/imf/openbb_imf/models/economic_indicators.py:328

        # Validate country requirement - must have country by now
        if not self.country:
            raise ValueError(
                "Country is required. Provide via 'country' parameter or include a country "
                "dimension (COUNTRY, REF_AREA, JURISDICTION, AREA) in 'dimension_values'."
            )

        symbols = [
            s.strip()
            for s in self.symbol.split(",")  #  type: ignore  # pylint: disable=E1101
        ]
        tables: list[str] = []
        indicators: list[tuple[str, str]] = []
        dataflows_seen: set[str] = set()

        for sym in symbols:
            if "::" not in sym:
                raise ValueError(
                    f"Invalid symbol format '{sym}'. Expected 'dataflow::identifier'. "
                    "Use `available_indicators()` or `list_tables()` to find valid symbols."
                )

            parts = sym.split("::", 1)
            dataflow = parts[0].strip().upper()
            identifier = parts[1].strip()

            if not identifier:
                raise ValueError(
                    f"Invalid symbol format '{sym}'. Identifier cannot be empty. "
                    "Expected 'dataflow::identifier'."
                )

            dataflows_seen.add(dataflow)
            # Tables can start with H_ or be any valid hierarchy ID for the dataflow
            is_table = False

View on GitHub (pinned to 3e071fcc2c)

Solutions

1. Format the symbol as 'dataflow::identifier'.
2. Use available_indicators() or list_tables() to find valid symbols.

When it happens

Trigger: Thrown at openbb_platform/providers/imf/openbb_imf/models/economic_indicators.py:328 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of OpenBB-finance/OpenBB@3e071fcc2c (2026-08-14). Data as JSON: /api/errors/63bc96fe37d10165. Report an issue: GitHub.