OpenBB-finance/OpenBB · warning · EmptyDataError

No FOMC documents found.

Error message

No FOMC documents found.

What it means

Raised as EmptyDataError by FederalReserveFomcDocuments.transform_data when get_fomc_documents_by_year returned an empty list for the requested year/document_type combination. The fetch itself succeeded; nothing matched the filters.

Source

Thrown at openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/fomc_documents.py:171

        **kwargs: Any,
    ) -> list[dict]:
        """Extract the raw data."""
        # pylint: disable=import-outside-toplevel
        from openbb_federal_reserve.utils.fomc_documents import (
            get_fomc_documents_by_year,
        )

        return get_fomc_documents_by_year(query.year, query.document_type)

    @staticmethod
    def transform_data(
        query: FederalReserveFomcDocumentsQueryParams,
        data: list[dict],
        **kwargs: Any,
    ) -> list[FederalReserveFomcDocumentsData]:
        """Transform data."""
        if not data:
            raise EmptyDataError("No FOMC documents found.")
        return [FederalReserveFomcDocumentsData.model_validate(d) for d in data]

View on GitHub (pinned to 3e071fcc2c)

Solutions

  1. Drop the document_type filter for that year to see what does exist.
  2. Verify the year is within 1959-present and that the type exists for it (e.g. press conference files only from ~2011 on).
  3. Catch EmptyDataError and continue when iterating years.
Defensive patterns

Strategy: try-catch

Validate before calling

if document_type == 'press_conference' and year < 2011:
    raise EmptyDataError('press conference documents start ~2011')  # pre-check known gaps

Try / catch

from openbb_core.provider.standard_errors import EmptyDataError
try:
    docs = obb.economy.fomc_documents(year=y, document_type=t)
except EmptyDataError:
    docs = None  # no documents of this type for this year

Prevention

When it happens

Trigger: Requesting FOMC documents for a year with no documents of the chosen type (e.g. press_conference transcripts before 2011-ish, or a future year), or a year outside 1959-present coverage.

Common situations: Programmatically looping over years where some types do not exist; assuming all document types exist for all years; year passed as a string with bad formatting.

Related errors


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