Upload 468 files

.gitattributes

@@ -14,3 +14,5 @@ openbb_platform/providers/bls/openbb_bls/assets/ppi_series.xz filter=lfs diff=lf
 openbb_platform/providers/bls/openbb_bls/assets/sla_series.xz filter=lfs diff=lfs merge=lfs -text
 openbb_platform/providers/bls/openbb_bls/assets/tu_series.xz filter=lfs diff=lfs merge=lfs -text
 openbb_platform/providers/bls/openbb_bls/assets/wages_series.xz filter=lfs diff=lfs merge=lfs -text
+openbb_platform/providers/finra/tests/record/http/test_finra_fetchers/test_finra_short_interest_fetcher_urllib3_v1.yaml filter=lfs diff=lfs merge=lfs -text
+openbb_platform/providers/finra/tests/record/http/test_finra_fetchers/test_finra_short_interest_fetcher_urllib3_v2.yaml filter=lfs diff=lfs merge=lfs -text

openbb_platform/providers/federal_reserve/README.md

@@ -0,0 +1,13 @@
+# OpenBB Federal Reserve Provider
+
+This extension integrates the [Federal Reserve](https://www.federalreserve.gov/data.htm) data provider into the OpenBB Platform.
+
+## Installation
+
+To install the extension:
+
+```bash
+pip install openbb-federal-reserve
+```
+
+Documentation available [here](https://docs.openbb.co/platform/developer_guide/contributing).

openbb_platform/providers/federal_reserve/__init__.py

@@ -0,0 +1 @@
+"""Federal Reserve provider for OpenBB Platform."""

openbb_platform/providers/federal_reserve/openbb_federal_reserve/__init__.py

@@ -0,0 +1,48 @@
+"""Federal Reserve provider module."""
+
+from openbb_core.provider.abstract.provider import Provider
+from openbb_federal_reserve.models.central_bank_holdings import (
+    FederalReserveCentralBankHoldingsFetcher,
+)
+from openbb_federal_reserve.models.federal_funds_rate import (
+    FederalReserveFederalFundsRateFetcher,
+)
+from openbb_federal_reserve.models.fomc_documents import (
+    FederalReserveFomcDocumentsFetcher,
+)
+from openbb_federal_reserve.models.money_measures import (
+    FederalReserveMoneyMeasuresFetcher,
+)
+from openbb_federal_reserve.models.overnight_bank_funding_rate import (
+    FederalReserveOvernightBankFundingRateFetcher,
+)
+from openbb_federal_reserve.models.primary_dealer_fails import (
+    FederalReservePrimaryDealerFailsFetcher,
+)
+from openbb_federal_reserve.models.primary_dealer_positioning import (
+    FederalReservePrimaryDealerPositioningFetcher,
+)
+from openbb_federal_reserve.models.sofr import FederalReserveSOFRFetcher
+from openbb_federal_reserve.models.treasury_rates import (
+    FederalReserveTreasuryRatesFetcher,
+)
+from openbb_federal_reserve.models.yield_curve import FederalReserveYieldCurveFetcher
+
+federal_reserve_provider = Provider(
+    name="federal_reserve",
+    website="https://www.federalreserve.gov/data.htm",  #  Not a typo, it's really .htm
+    description="""Access data provided by the Federal Reserve System, the Central Bank of the United States.""",
+    fetcher_dict={
+        "CentralBankHoldings": FederalReserveCentralBankHoldingsFetcher,
+        "FederalFundsRate": FederalReserveFederalFundsRateFetcher,
+        "FomcDocuments": FederalReserveFomcDocumentsFetcher,
+        "MoneyMeasures": FederalReserveMoneyMeasuresFetcher,
+        "OvernightBankFundingRate": FederalReserveOvernightBankFundingRateFetcher,
+        "PrimaryDealerFails": FederalReservePrimaryDealerFailsFetcher,
+        "PrimaryDealerPositioning": FederalReservePrimaryDealerPositioningFetcher,
+        "SOFR": FederalReserveSOFRFetcher,
+        "TreasuryRates": FederalReserveTreasuryRatesFetcher,
+        "YieldCurve": FederalReserveYieldCurveFetcher,
+    },
+    repr_name="Federal Reserve (FED)",
+)

openbb_platform/providers/federal_reserve/openbb_federal_reserve/assets/__init__.py

@@ -0,0 +1 @@
+"""OpenBB Federal Reserve Provider Assets."""

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/central_bank_holdings.py

@@ -0,0 +1,368 @@
+"""Federal Reserve Central Bank Holdings Model."""
+
+# pylint: disable=unused-argument,too-many-branches,too-many-statements,too-many-return-statements
+
+from datetime import date as dateType
+from typing import Any, Dict, List, Literal, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.central_bank_holdings import (
+    CentralBankHoldingsData,
+    CentralBankHoldingsQueryParams,
+)
+from openbb_core.provider.utils.descriptions import (
+    DATA_DESCRIPTIONS,
+    QUERY_DESCRIPTIONS,
+)
+from pydantic import Field, field_validator, model_validator
+
+HoldingTypes = Literal[
+    "all_agency",
+    "agency_debts",
+    "mbs",
+    "cmbs",
+    "all_treasury",
+    "bills",
+    "notesbonds",
+    "frn",
+    "tips",
+]
+HOLDING_TYPE_CHOICES = [
+    "all_agency",
+    "agency_debts",
+    "mbs",
+    "cmbs",
+    "all_treasury",
+    "bills",
+    "notesbonds",
+    "frn",
+    "tips",
+]
+AGENCY_HOLDING_TYPES = {
+    "all": "all",
+    "agency_debts": "agency%20debts",
+    "mbs": "mbs",
+    "cmbs": "cmbs",
+}
+TREASURY_HOLDING_TYPES = ["all", "bills", "notesbonds", "frn", "tips"]
+
+
+class FederalReserveCentralBankHoldingsQueryParams(CentralBankHoldingsQueryParams):
+    """Federal Reserve Central Bank Holdings Query.
+
+    The SOMA database contains data on the Federal Reserve's
+    domestic securities holdings from 2003 to the present.
+    SOMA holdings data is as of the close of business each Wednesday
+    and is published every Thursday by close of business.
+
+    Source: https://www.newyorkfed.org/markets/soma-holdings
+    """
+
+    __json_schema_extra__ = {
+        "cusip": {"multiple_items_allowed": True},
+    }
+
+    holding_type: HoldingTypes = Field(
+        default="all_treasury",
+        description="Type of holdings to return.",
+        json_schema_extra={"choices": HOLDING_TYPE_CHOICES},
+    )
+    summary: bool = Field(
+        default=False,
+        description="If True, returns historical weekly summary by holding type."
+        + " This parameter takes priority over other parameters.",
+    )
+    cusip: Optional[str] = Field(
+        default=None,
+        description=QUERY_DESCRIPTIONS.get("cusip", ""),
+    )
+    wam: bool = Field(
+        default=False,
+        description="If True, returns weighted average maturity aggregated by agency or treasury securities."
+        + " This parameter takes priority over `holding_type`, `cusip`, and `monthly`.",
+    )
+    monthly: bool = Field(
+        default=False,
+        description="If True, returns historical data for all Treasury securities at a monthly interval."
+        + " This parameter takes priority over other parameters, except `wam`."
+        + " Only valid when `holding_type` is set to: 'all_treasury', 'bills', 'notesbonds', 'frn', 'tips'.",
+    )
+
+
+class FederalReserveCentralBankHoldingsData(CentralBankHoldingsData):
+    """Federal Reserve Central Bank Holdings Data."""
+
+    __alias_dict__ = {
+        "date": "asOfDate",
+        "notes_and_bonds": "notesbonds",
+        "description": "securityDescription",
+        "face_value": "currentFaceValue",
+        "is_aggregated": "isAggregated",
+        "security_type": "securityTypes",
+        "tips_inflation_compensation": "tipsInflationCompensation",
+        "change_prior_week": "changeFromPriorWeek",
+        "change_prior_year": "changeFromPriorYear",
+    }
+
+    security_type: Optional[str] = Field(
+        default=None,
+        description="Type of security - i.e. TIPs, FRNs, etc.",
+    )
+    description: Optional[str] = Field(
+        default=None,
+        description="Description of the security. Only returned for Agency securities.",
+    )
+    is_aggreated: Optional[Literal["Y"]] = Field(
+        default=None,
+        description="Whether the security is aggregated. Only returned for Agency securities.",
+    )
+    cusip: Optional[str] = Field(
+        default=None,
+        description=DATA_DESCRIPTIONS.get("cusip", ""),
+    )
+    issuer: Optional[str] = Field(
+        default=None,
+        description="Issuer of the security.",
+    )
+    maturity_date: Optional[dateType] = Field(
+        default=None,
+        description="Maturity date of the security.",
+    )
+    term: Optional[str] = Field(
+        default=None,
+        description="Term of the security. Only returned for Agency securities.",
+    )
+    face_value: Optional[float] = Field(
+        default=None,
+        description="Current face value of the security (Thousands of $USD)."
+        + " Current face value of the securities, which is the remaining principal balance of the securities.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    par_value: Optional[float] = Field(
+        default=None,
+        description="Par value of the security (Thousands of $USD)."
+        + " Changes in par may reflect primary and secondary market transactions and/or custodial account activity.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    coupon: Optional[float] = Field(
+        default=None,
+        description="Coupon rate of the security.",
+        json_schema_extra={"x-unit_measurement": "percent", "x-frontend_multiply": 100},
+    )
+    spread: Optional[float] = Field(
+        default=None,
+        description="Spread to the current reference rate, as determined at each security's initial auction.",
+        json_schema_extra={"x-unit_measurement": "percent", "x-frontend_multiply": 100},
+    )
+    percent_outstanding: Optional[float] = Field(
+        default=None,
+        description="Total percent of the outstanding CUSIP issuance.",
+        json_schema_extra={"x-unit_measurement": "percent", "x-frontend_multiply": 100},
+    )
+    bills: Optional[float] = Field(
+        default=None,
+        description="Treasury bills amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    frn: Optional[float] = Field(
+        default=None,
+        description="Floating rate Treasury notes amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    notes_and_bonds: Optional[float] = Field(
+        default=None,
+        description="Treasuy Notes and bonds amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    tips: Optional[float] = Field(
+        default=None,
+        description="Treasury inflation-protected securities amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    mbs: Optional[float] = Field(
+        default=None,
+        description="Mortgage-backed securities amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    cmbs: Optional[float] = Field(
+        default=None,
+        description="Commercial mortgage-backed securities amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    agencies: Optional[float] = Field(
+        default=None,
+        description="Agency securities amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    total: Optional[float] = Field(
+        default=None,
+        description="Total SOMA holdings amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    tips_inflation_compensation: Optional[float] = Field(
+        default=None,
+        description="Treasury inflation-protected securities inflation compensation amount (Thousands of $USD)."
+        + " Only returned when 'summary' is True.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+        alias="inflationCompensation",
+    )
+    change_prior_week: Optional[float] = Field(
+        default=None,
+        description="Change in SOMA holdings from the prior week (Thousands of $USD).",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+    change_prior_year: Optional[float] = Field(
+        default=None,
+        description="Change in SOMA holdings from the prior year (Thousands of $USD).",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1000,
+        },
+    )
+
+    @field_validator("security_type", mode="before", check_fields=False)
+    @classmethod
+    def validate_security_type(cls, v):
+        """Validate the security type."""
+        if not v:
+            return None
+        if isinstance(v, list):
+            return ",".join(v)
+        return v
+
+    @field_validator("coupon", "spread", mode="before", check_fields=False)
+    @classmethod
+    def normalize_percent(cls, v):
+        """Normalize the percent value."""
+        return float(v) / 100 if v and v != "''" else None
+
+    @model_validator(mode="before")
+    @classmethod
+    def empty_strings(cls, values):
+        """Clear empty strings and replace with None."""
+        return (
+            {k: None if v in ("''", "", "0") else v for k, v in values.items()}
+            if isinstance(values, dict)
+            else values
+        )
+
+
+class FederalReserveCentralBankHoldingsFetcher(
+    Fetcher[
+        FederalReserveCentralBankHoldingsQueryParams,
+        List[FederalReserveCentralBankHoldingsData],
+    ]
+):
+    """Federal Reserve Central Bank Holdings Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReserveCentralBankHoldingsQueryParams:
+        """Transform the query params."""
+        return FederalReserveCentralBankHoldingsQueryParams(**params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReserveCentralBankHoldingsQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Return the raw data from the FederalReserve endpoint."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_federal_reserve.utils.ny_fed_api import SomaHoldings
+
+        hold_type = "all" if "all" in query.holding_type else query.holding_type
+        security_type = query.holding_type
+        date = query.date.strftime("%Y-%m-%d") if query.date else None
+        if (
+            query.holding_type == "all_agency"
+            or query.holding_type in AGENCY_HOLDING_TYPES
+        ):
+            security_type = "agency"  # type: ignore
+        if (
+            query.holding_type == "all_treasury"
+            or query.holding_type in TREASURY_HOLDING_TYPES
+        ):
+            security_type = "treasury"  # type: ignore
+        if query.cusip is not None:
+            cusips = (
+                query.cusip if isinstance(query.cusip, str) else ",".join(query.cusip)
+            )
+            return (
+                await SomaHoldings().get_agency_holdings(cusip=cusips, as_of=date)
+                if security_type == "agency"
+                else await SomaHoldings().get_treasury_holdings(
+                    cusip=cusips, as_of=date
+                )
+            )
+        if query.summary is True:
+            return await SomaHoldings().get_summary()
+        if query.monthly is True:
+            return await SomaHoldings().get_treasury_holdings(
+                monthly=True, holding_type=hold_type
+            )
+        if security_type == "treasury" and query.wam is True:
+            return await SomaHoldings().get_treasury_holdings(wam=True, as_of=date)
+        if security_type == "agency" and query.wam is True:
+            return await SomaHoldings().get_agency_holdings(wam=True, as_of=date)
+        return (
+            await SomaHoldings().get_agency_holdings(as_of=date, holding_type=hold_type)
+            if security_type == "agency"
+            else await SomaHoldings().get_treasury_holdings(
+                as_of=date, holding_type=hold_type
+            )
+        )
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveCentralBankHoldingsQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReserveCentralBankHoldingsData]:
+        """Transform data."""
+        return [FederalReserveCentralBankHoldingsData.model_validate(d) for d in data]

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/federal_funds_rate.py

@@ -0,0 +1,141 @@
+"""Federal Reserve Federal Funds Rate Model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.federal_funds_rate import (
+    FederalFundsRateData,
+    FederalFundsRateQueryParams,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from pydantic import Field, field_validator
+
+
+class FederalReserveFederalFundsRateQueryParams(FederalFundsRateQueryParams):
+    """FederalReserve FED Query."""
+
+
+class FederalReserveFederalFundsRateData(FederalFundsRateData):
+    """FederalReserve FED Data."""
+
+    __alias_dict__ = {
+        "date": "effectiveDate",
+        "rate": "percentRate",
+        "target_range_upper": "targetRateTo",
+        "target_range_lower": "targetRateFrom",
+        "percentile_1": "percentPercentile1",
+        "percentile_25": "percentPercentile25",
+        "percentile_75": "percentPercentile75",
+        "percentile_99": "percentPercentile99",
+        "volume": "volumeInBillions",
+        "intraday_low": "intraDayLow",
+        "intraday_high": "intraDayHigh",
+        "standard_deviation": "stdDeviation",
+        "revision_indicator": "revisionIndicator",
+    }
+
+    intraday_low: Optional[float] = Field(
+        default=None,
+        description="Intraday low. This field is only present for data before 2016.",
+    )
+    intraday_high: Optional[float] = Field(
+        default=None,
+        description="Intraday high. This field is only present for data before 2016.",
+    )
+    standard_deviation: Optional[float] = Field(
+        default=None,
+        description="Standard deviation. This field is only present for data before 2016.",
+    )
+    revision_indicator: Optional[str] = Field(
+        default=None,
+        description="Indicates a revision of the data for that date.",
+    )
+
+    @field_validator("revision_indicator", mode="before", check_fields=False)
+    @classmethod
+    def validate_revision_indicator(cls, v):
+        """Validate revision indicator."""
+        return None if v in ("", "''") else v
+
+    @field_validator(
+        "rate",
+        "target_range_upper",
+        "target_range_lower",
+        "percentile_1",
+        "percentile_25",
+        "percentile_75",
+        "percentile_99",
+        "intraday_high",
+        "intraday_low",
+        mode="before",
+        check_fields=False,
+    )
+    @classmethod
+    def normalize_percent(cls, v):
+        """Normalize percent."""
+        if v is not None:
+            return v / 100 if v != 0 else 0
+        return None
+
+
+class FederalReserveFederalFundsRateFetcher(
+    Fetcher[
+        FederalReserveFederalFundsRateQueryParams,
+        List[FederalReserveFederalFundsRateData],
+    ]
+):
+    """Federal Reserve Federal Funds Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReserveFederalFundsRateQueryParams:
+        """Transform query."""
+        transformed_params = params.copy()
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = datetime(2016, 3, 1).date()
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return FederalReserveFederalFundsRateQueryParams(**transformed_params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReserveFederalFundsRateQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the raw data."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_core.provider.utils.helpers import amake_request
+
+        url = (
+            "https://markets.newyorkfed.org/api/rates/unsecured/effr/search.json?"
+            + f"startDate={query.start_date}&endDate={query.end_date}"
+        )
+        results: List[Dict] = []
+        response = await amake_request(url, **kwargs)  # type: ignore
+        if response.get("refRates"):  # type: ignore
+            results = response["refRates"]  # type: ignore
+        if not results:
+            raise EmptyDataError()
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveFederalFundsRateQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReserveFederalFundsRateData]:
+        """Transform data."""
+        results: List[FederalReserveFederalFundsRateData] = []
+        for d in data.copy():
+            _ = d.pop("type", None)
+            _ = d.pop("footnoteId", None)
+            results.append(FederalReserveFederalFundsRateData.model_validate(d))
+
+        return results

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/fomc_documents.py

@@ -0,0 +1,219 @@
+"""Federal Reserve FOMC documents model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import Any, Optional
+
+from openbb_core.provider.abstract.data import Data
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.abstract.query_params import QueryParams
+from openbb_core.provider.utils.errors import EmptyDataError
+from openbb_federal_reserve.utils.fomc_documents import FomcDocumentType
+from pydantic import Field, field_validator
+
+choice_types = list(FomcDocumentType.__args__)
+choices = [
+    {
+        "label": (
+            "All Documents" if choice == "all" else choice.replace("_", " ").title()
+        ),
+        "value": choice if choice != "all" else None,
+    }
+    for choice in choice_types
+]
+
+
+class FederalReserveFomcDocumentsQueryParams(QueryParams):
+    """Federal Reserve FOMC Documents Query."""
+
+    __json_schema_extra__ = {
+        "year": {
+            "x-widget_config": {
+                "type": "number",
+                "value": None,
+                "options": [
+                    {"label": "All Years", "value": None},
+                    *[
+                        {"label": str(year), "value": year}
+                        for year in sorted(
+                            range(1959, datetime.now().year + 1), reverse=True
+                        )
+                    ],
+                ],
+            }
+        },
+        "document_type": {
+            "x-widget_config": {
+                "type": "text",
+                "value": None,
+                "options": choices,
+            }
+        },
+        "pdf_only": {
+            "x-widget_config": {"value": True, "type": "boolean", "show": False}
+        },
+        "as_choices": {
+            "x-widget_config": {"value": True, "type": "boolean", "show": False}
+        },
+        "url": {
+            "x-widget_config": {
+                "type": "endpoint",
+                "paramName": "url",
+                "optionsEndpoint": "api/v1/economy/fomc_documents",
+                "optionsParams": {
+                    "document_type": "$document_type",
+                    "year": "$year",
+                    "pdf_only": True,
+                    "as_choices": True,
+                    "provider": "federal_reserve",
+                },
+                "show": False,
+                "roles": ["fileSelector"],
+            }
+        },
+    }
+
+    year: Optional[int] = Field(
+        default=None,
+        description="The year of FOMC documents to retrieve. If None, all years since 1959 are returned.",
+    )
+    document_type: Optional[str] = Field(
+        default=None,
+        description=f"Filter by document type. Default is all. Choose from: {', '.join(choice_types)}",
+    )
+    pdf_only: bool = Field(
+        default=False,
+        description="Whether to return as a list with only the PDF documents. Default is False.",
+    )
+    as_choices: bool = Field(
+        default=False,
+        description="Whether to return cast as a list of valid Workspace parameter choices."
+        + " Leave as False for typical use.",
+    )
+    url: Optional[str] = Field(
+        default=None,
+        description="Download a document from the supplied URL."
+        + " When provided, all other parameters are ignored."
+        + " Content is returned as a base64 encoded string.",
+    )
+
+    @field_validator("document_type", mode="before", check_fields=False)
+    @classmethod
+    def _validate_doc_type(cls, v):
+        """Validate document type."""
+        if v and v not in choice_types:
+            raise ValueError(
+                f"Invalid document type. Must be one of: {', '.join(choice_types)}"
+            )
+        return v
+
+    @field_validator("url", mode="before", check_fields=False)
+    @classmethod
+    def _validate_url(cls, v):
+        """Validate URL."""
+        if v and "federalreserve.gov" not in v:
+            raise ValueError("Invalid URL. Must be a Federal Reserve URL.")
+        return v if v else None
+
+
+class FederalReserveFomcDocumentsData(Data):
+    """Federal Reserve FOMC Documents Data."""
+
+    content: Any = Field(
+        default=None,
+        description="The content of request results."
+        + " If `url` was provided, the content is a dictionary with keys `filename` and `content`."
+        + " Otherwise, it is a list of dictionaries with a mapping of FOMC documents to URLs."
+        + " The endpoint response will not be an OBBject.results object, but the content directly.",
+    )
+
+
+class FederalReserveFomcDocumentsFetcher(
+    Fetcher[
+        FederalReserveFomcDocumentsQueryParams,
+        FederalReserveFomcDocumentsData,
+    ]
+):
+    """Federal Reserve FOMC Documents Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: dict[str, Any],
+    ) -> FederalReserveFomcDocumentsQueryParams:
+        """Transform query."""
+        return FederalReserveFomcDocumentsQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: FederalReserveFomcDocumentsQueryParams,
+        credentials: Optional[dict[str, str]],
+        **kwargs: Any,
+    ) -> dict:
+        """Extract the raw data."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_core.provider.utils.helpers import make_request
+        from openbb_federal_reserve.utils.fomc_documents import (
+            get_fomc_documents_by_year,
+        )
+        from openbb_platform_api.response_models import PdfResponseModel
+
+        if query.url:
+            response = make_request(query.url)
+            response.raise_for_status()
+            pdf = response.content
+            if query.url.endswith(".pdf"):
+                content = PdfResponseModel(
+                    filename=query.url.split("/")[-1], content=pdf
+                )
+                output = {
+                    "content": content.model_dump(exclude_unset=True, exclude_none=True)
+                }
+                return output
+
+            output = {
+                "content": {
+                    "filename": query.url.split("/")[-1],
+                    "content": pdf,
+                    "data_format": "markdown",
+                }
+            }
+
+            return output
+
+        docs = get_fomc_documents_by_year(
+            query.year, query.document_type, query.pdf_only
+        )
+
+        if query.as_choices is True:
+            choices_list: list = []
+            for doc in docs:
+                if query.pdf_only is True and doc.get("doc_format", "") != "pdf":
+                    continue
+                title = (
+                    doc.get("doc_type", "").replace("_", " ").title()
+                    + " - "
+                    + doc.get("date", "")
+                )
+                value = doc.get("url", "")
+                if title and value:
+                    choices_list.append({"label": title, "value": value})
+
+            output = {"content": choices_list}
+
+            return output
+
+        output = {"content": docs}
+
+        return output
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveFomcDocumentsQueryParams,
+        data: dict,
+        **kwargs: Any,
+    ) -> FederalReserveFomcDocumentsData:
+        """Transform data."""
+        if not data:
+            raise EmptyDataError("No FOMC documents found.")
+        return FederalReserveFomcDocumentsData(content=data.get("content"))

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/money_measures.py

@@ -0,0 +1,112 @@
+"""FederalReserve Money Measures Model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.money_measures import (
+    MoneyMeasuresData,
+    MoneyMeasuresQueryParams,
+)
+
+titles = {
+    "M1": "M1",
+    "M2": "M2",
+    "MCU": "currency",
+    "MDD": "demand_deposits",
+    "MMFGB": "retail_money_market_funds",
+    "MDL": "other_liquid_deposits",
+    "MDTS": "small_denomination_time_deposits",
+}
+
+
+class FederalReserveMoneyMeasuresQueryParams(MoneyMeasuresQueryParams):
+    """FederalReserve Money Measures Query."""
+
+
+class FederalReserveMoneyMeasuresData(MoneyMeasuresData):
+    """FederalReserve Money Measures Data."""
+
+
+class FederalReserveMoneyMeasuresFetcher(
+    Fetcher[
+        FederalReserveMoneyMeasuresQueryParams,
+        List[FederalReserveMoneyMeasuresData],
+    ]
+):
+    """Transform the query, extract and transform the data from the FederalReserve endpoints."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReserveMoneyMeasuresQueryParams:
+        """Transform the query params. Start and end dates are set to a 90 day interval."""
+        # pylint: disable=import-outside-toplevel
+        from datetime import timedelta
+
+        transformed_params = params
+
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = now - timedelta(days=10 * 365)
+
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return FederalReserveMoneyMeasuresQueryParams(**transformed_params)
+
+    @staticmethod
+    def extract_data(
+        query: FederalReserveMoneyMeasuresQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Return the raw data from the FederalReserve endpoint."""
+        # pylint: disable=import-outside-toplevel
+        from io import BytesIO  # noqa
+        from openbb_core.provider.utils.helpers import make_request  # noqa
+        from pandas import read_csv, to_datetime  # noqa
+
+        url = (
+            "https://www.federalreserve.gov/datadownload/Output.aspx?rel=H6&series=798e2796917702a5f8423426ba7e6b42"
+            "&lastobs=&from=&to=&filetype=csv&label=include&layout=seriescolumn&type=package"
+        )
+
+        r = make_request(url, **kwargs)
+        df = read_csv(BytesIO(r.content), header=5, index_col=None, parse_dates=True)
+
+        columns_to_get = ["Time Period"] + [
+            col + f'{"_N" if query.adjusted else ""}.M' for col in titles
+        ]
+        df = df[columns_to_get]
+        df.columns = ["month"] + list(titles.values())
+        df = df.replace("ND", None)
+        df["month"] = to_datetime(df["month"])
+        df = df[
+            (to_datetime(df.month) >= to_datetime(query.start_date))
+            & (to_datetime(df.month) <= to_datetime(query.end_date))
+        ].set_index("month")
+        # Needs the date to not be in the columns
+        df = df.applymap(lambda x: float(x) if x != "-" and x is not None else x)
+        df = df.reset_index(drop=False)
+
+        return df.to_dict(orient="records")
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveMoneyMeasuresQueryParams, data: List[Dict], **kwargs: Any
+    ) -> List[FederalReserveMoneyMeasuresData]:
+        """Return the transformed data."""
+        # pylint: disable=import-outside-toplevel
+        from pandas import isna
+
+        fed_data = []
+        for d in data:
+            for k, v in d.items():
+                if isna(v) and not isinstance(v, str):
+                    d[k] = None
+            fed_data.append(FederalReserveMoneyMeasuresData.model_validate(d))
+
+        return fed_data

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/overnight_bank_funding_rate.py

@@ -0,0 +1,122 @@
+"""Federal Reserve Federal Funds Rate Model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.overnight_bank_funding_rate import (
+    OvernightBankFundingRateData,
+    OvernightBankFundingRateQueryParams,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from pydantic import Field, field_validator
+
+
+class FederalReserveOvernightBankFundingRateQueryParams(
+    OvernightBankFundingRateQueryParams
+):
+    """FederalReserve Overnight Bank Funding Rate Query."""
+
+
+class FederalReserveOvernightBankFundingRateData(OvernightBankFundingRateData):
+    """FederalReserve Overnight Bank Funding Rate Data."""
+
+    __alias_dict__ = {
+        "date": "effectiveDate",
+        "rate": "percentRate",
+        "percentile_1": "percentPercentile1",
+        "percentile_25": "percentPercentile25",
+        "percentile_75": "percentPercentile75",
+        "percentile_99": "percentPercentile99",
+        "volume": "volumeInBillions",
+    }
+
+    revision_indicator: Optional[str] = Field(
+        default=None,
+        description="Indicates a revision of the data for that date.",
+    )
+
+    @field_validator("revision_indicator", mode="before", check_fields=False)
+    @classmethod
+    def validate_revision_indicator(cls, v):
+        """Validate revision indicator."""
+        return None if v in ("", "''") else v
+
+    @field_validator(
+        "rate",
+        "percentile_1",
+        "percentile_25",
+        "percentile_75",
+        "percentile_99",
+        mode="before",
+        check_fields=False,
+    )
+    @classmethod
+    def normalize_percent(cls, v):
+        """Normalize percent."""
+        if v is not None:
+            return v / 100 if v != 0 else 0
+        return None
+
+
+class FederalReserveOvernightBankFundingRateFetcher(
+    Fetcher[
+        FederalReserveOvernightBankFundingRateQueryParams,
+        List[FederalReserveOvernightBankFundingRateData],
+    ]
+):
+    """Federal Reserve Federal Funds Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReserveOvernightBankFundingRateQueryParams:
+        """Transform query."""
+        transformed_params = params.copy()
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = datetime(2016, 3, 1).date()
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return FederalReserveOvernightBankFundingRateQueryParams(**transformed_params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReserveOvernightBankFundingRateQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the raw data."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_core.provider.utils.helpers import amake_request
+
+        url = (
+            "https://markets.newyorkfed.org/api/rates/unsecured/obfr/search.json?"
+            + f"startDate={query.start_date}&endDate={query.end_date}"
+        )
+        results: List[Dict] = []
+        response = await amake_request(url, **kwargs)
+        if response.get("refRates", []):  # type: ignore
+            results = response["refRates"]  # type: ignore
+        if not results:
+            raise EmptyDataError()
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveOvernightBankFundingRateQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReserveOvernightBankFundingRateData]:
+        """Transform data."""
+        results: List[FederalReserveOvernightBankFundingRateData] = []
+        for d in data.copy():
+            _ = d.pop("type", None)
+            _ = d.pop("revisionIndicator", None)
+            _ = d.pop("footnoteId", None)
+            results.append(FederalReserveOvernightBankFundingRateData.model_validate(d))
+
+        return results

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/primary_dealer_fails.py

@@ -0,0 +1,186 @@
+"""Federal Reserve Primary Dealer Fails Model."""
+
+# pylint: disable=unused-argument
+
+from typing import Any, Dict, List, Literal, Optional, Union
+
+from openbb_core.app.model.abstract.error import OpenBBError
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.primary_dealer_fails import (
+    PrimaryDealerFailsData,
+    PrimaryDealerFailsQueryParams,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from openbb_federal_reserve.utils.primary_dealer_statistics import FAILS_SERIES_TO_TITLE
+from pydantic import Field
+
+
+class FederalReservePrimaryDealerFailsQueryParams(PrimaryDealerFailsQueryParams):
+    """Federal Reserve Primary Dealer Fails Query Params."""
+
+    __json_schema_extra__ = {
+        "asset_class": {
+            "multiple_items_allowed": False,
+            "choices": ["all", "treasuries", "tips", "agency", "mbs", "corporate"],
+        },
+        "unit": {
+            "multiple_items_allowed": False,
+            "choices": ["value", "percent"],
+        },
+    }
+
+    asset_class: Literal["all", "treasuries", "tips", "agency", "mbs", "corporate"] = (
+        Field(
+            default="all",
+            description="Asset class to return, default is 'all'.",
+        )
+    )
+    unit: Literal["value", "percent"] = Field(
+        default="value",
+        description="Unit of the data returned to the 'value' field."
+        + " Default is 'value', which represents millions of USD."
+        + " 'percent' returns data as the percentage of the total"
+        + " fails-to-receive and fails-to-deliver, by asset class.",
+    )
+
+
+class FederalReservePrimaryDealerFailsData(PrimaryDealerFailsData):
+    """Federal Reserve Primary Dealer Fails Data."""
+
+    title: str = Field(description="Title of the series' symbol.")
+    value: Union[int, float] = Field(
+        description="Value of the data returned, in millions of USD if the `unit`"
+        + " parameter is 'value' else a normalized percent."
+    )
+
+
+class FederalReservePrimaryDealerFailsFetcher(
+    Fetcher[
+        FederalReservePrimaryDealerFailsQueryParams,
+        List[FederalReservePrimaryDealerFailsData],
+    ]
+):
+    """Federal Reserve Primary Dealer Fails Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReservePrimaryDealerFailsQueryParams:
+        """Transform the query parameters."""
+        return FederalReservePrimaryDealerFailsQueryParams(**params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReservePrimaryDealerFailsQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Return the raw data from the Federal Reserve endpoint."""
+        # pylint: disable=import-outside-toplevel
+        from datetime import datetime  # noqa
+        from openbb_core.provider.utils.helpers import amake_request
+
+        url = (
+            "https://markets.newyorkfed.org/api/pd/get/"
+            + "PDFTD-CS_PDFTR-CS_PDFTD-FGEM_PDFTR-FGEM_PDFTD-FGM_PDFTR-FGM_PDFTD-OM_"
+            + "PDFTR-OM_PDFTD-UST_PDFTR-UST_PDFTD-USTET_PDFTR-USTET.json"
+        )
+        try:
+
+            response = await amake_request(url, **kwargs)
+            data = response.get("pd", {}).get("timeseries", [])  # type: ignore
+            if query.start_date and query.start_date < datetime(2013, 4, 1).date():
+                # The data is broken into different series and the structure of the data is different over time.
+                if query.start_date < datetime(2001, 7, 1).date():
+                    url2 = (
+                        "https://markets.newyorkfed.org/api/pd/get/SBP2001/timeseries/PDFASUFDA_PDFASUFRA"
+                        + "_PDFASFAFDA_PDFASFAFRA_PDFASMBFDA_PDFASMBFRA.json"
+                    )
+                    response = await amake_request(url2, **kwargs)
+                    data += response.get("pd", {}).get("timeseries", [])  # type: ignore
+                url = (
+                    "https://markets.newyorkfed.org/api/pd/get/SBP2013/timeseries/"
+                    + "PDFASCFRA_PDFASCFDA_PDFASFAFRA_PDFASFAFDA_PDFASMBFRA_PDFASMBFDA_PDFASUFRA_PDFASUFDA.json"
+                )
+                response = await amake_request(url, **kwargs)
+                data += response.get("pd", {}).get("timeseries", [])  # type: ignore
+            return data
+        except Exception as e:  # pylint: disable=broad-except
+            raise OpenBBError(
+                "Failed to fetch data from the Federal Reserve API."
+            ) from e
+
+    @staticmethod
+    def transform_data(
+        query: FederalReservePrimaryDealerFailsQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReservePrimaryDealerFailsData]:
+        """Transform the raw data into the standard format."""
+        # pylint: disable=import-outside-toplevel
+        from pandas import NA, DataFrame, concat, to_datetime
+
+        if not data:
+            raise EmptyDataError("No data returned from the Federal Reserve API.")
+
+        df = DataFrame(data)
+        df.loc[:, "title"] = df.keyid.map(FAILS_SERIES_TO_TITLE)
+        df.value = df.value.astype(int)
+        new_df = df.pivot(index="asofdate", columns="title", values="value").copy()
+        new_data = new_df.copy()
+        combined_df = DataFrame()
+
+        for target in ["FTD", "FTR"]:
+            total_col = target + " Total"
+            new_data = new_df[[d for d in new_df.columns if target in d]].copy()
+            new_data.loc[:, total_col] = new_data.sum(axis=1)
+
+            if query.unit == "percent":
+                new_data = new_data.div(new_data[total_col], axis=0)
+
+            combined_df = (
+                new_data.copy()
+                if combined_df.empty
+                else concat([combined_df, new_data], axis=1)
+            )
+        new_data = combined_df
+
+        if query.asset_class == "agency":
+            new_data = new_data[[d for d in new_data.columns if "Ex-MBS" in d]]
+        if query.asset_class == "mbs":
+            new_data = new_data[
+                [d for d in new_data.columns if "MBS" in d and "Ex-MBS" not in d]
+            ]
+        if query.asset_class == "treasuries":
+            new_data = new_data[
+                [d for d in new_data.columns if "Treasury Securities (Ex-TIPS)" in d]
+            ]
+        if query.asset_class == "tips":
+            new_data = new_data[
+                [d for d in new_data.columns if "TIPS" in d and "Ex-TIPS" not in d]
+            ]
+        if query.asset_class == "corporate":
+            new_data = new_data[[d for d in new_data.columns if "Corporate" in d]]
+
+        new_data = new_data.T.unstack().reset_index()
+        new_data.columns = ["date", "title", "value"]
+        new_data.loc[:, "symbol"] = new_data.title.map(
+            {v: k for k, v in FAILS_SERIES_TO_TITLE.items()}
+        ).replace({NA: "--"})
+        new_data = new_data.dropna()
+
+        if query.unit == "value":
+            new_data.value = new_data.value.astype(int)
+
+        new_data.date = to_datetime(new_data.date).dt.date
+
+        if query.start_date:
+            new_data = new_data[new_data.date >= query.start_date]
+
+        if query.end_date:
+            new_data = new_data[new_data.date <= query.end_date]
+
+        return [
+            FederalReservePrimaryDealerFailsData.model_validate(r)
+            for r in new_data.dropna().to_dict(orient="records")
+        ]

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/primary_dealer_positioning.py

@@ -0,0 +1,152 @@
+"""Federal Reserve Primary Dealer Positioning Model."""
+
+# pylint: disable=unused-argument
+
+from typing import Any, Dict, List, Literal, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.primary_dealer_positioning import (
+    PrimaryDealerPositioningData,
+    PrimaryDealerPositioningQueryParams,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from pydantic import Field
+
+PdsCategories = Literal[
+    "treasuries",
+    "bills",
+    "coupons",
+    "notes",
+    "tips",
+    "mbs",
+    "cmbs",
+    "municipal",
+    "corporate",
+    "commercial_paper",
+    "corporate_ig",
+    "corporate_junk",
+    "abs",
+]
+
+PDS_CATEGORY_CHOICES = [
+    "treasuries",
+    "bills",
+    "coupons",
+    "notes",
+    "tips",
+    "mbs",
+    "cmbs",
+    "municipal",
+    "corporate",
+    "commercial_paper",
+    "corporate_ig",
+    "corporate_junk",
+    "abs",
+]
+
+
+class FederalReservePrimaryDealerPositioningQueryParams(
+    PrimaryDealerPositioningQueryParams
+):
+    """Federal Reserve Primary Dealer Positioning Query Params."""
+
+    category: PdsCategories = Field(
+        default="treasuries",
+        description="The category of asset to return, defaults to 'treasuries'.",
+        json_schema_extra={"choices": PDS_CATEGORY_CHOICES},  # type: ignore
+    )
+
+
+class FederalReservePrimaryDealerPositioningData(PrimaryDealerPositioningData):
+    """Federal Reserve Primary Dealer Positioning Data."""
+
+    value: int = Field(
+        description="The reported value of the net position (long - short), in millions of $USD.",
+        json_schema_extra={
+            "x-unit_measurement": "currency",
+            "x-frontend_multiply": 1e6,
+        },
+    )
+    name: str = Field(
+        description="Short name for the series.",
+    )
+    title: str = Field(
+        description="Title of the series.",
+    )
+
+
+class FederalReservePrimaryDealerPositioningFetcher(
+    Fetcher[
+        FederalReservePrimaryDealerPositioningQueryParams,
+        List[FederalReservePrimaryDealerPositioningData],
+    ]
+):
+    """Federal Reserve Primary Dealer Positioning Fetcher."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReservePrimaryDealerPositioningQueryParams:
+        """Transform the query params."""
+        return FederalReservePrimaryDealerPositioningQueryParams(**params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReservePrimaryDealerPositioningQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Return the raw data from the FederalReserve endpoint."""
+        # pylint: disable=import-outside-toplevel
+        import asyncio  # noqa
+        from openbb_core.provider.utils.helpers import amake_request
+        from openbb_federal_reserve.utils.primary_dealer_statistics import (
+            POSITION_GROUPS_TO_SERIES,
+        )
+
+        symbols = POSITION_GROUPS_TO_SERIES.get(query.category, [])
+        results: List[Dict] = []
+
+        base_url = "https://markets.newyorkfed.org/api/pd/get/"
+        urls = [base_url + symbol + ".json" for symbol in symbols]
+
+        async def get_one(url):
+            """Get data for a single URL."""
+            result = await amake_request(url)
+            if isinstance(result, dict):
+                data = result.get("pd", {}).get("timeseries")
+                if data:
+                    results.extend(data)
+
+        await asyncio.gather(*[get_one(url) for url in urls])
+
+        if not results:
+            raise EmptyDataError("The request was returned empty.")
+
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: FederalReservePrimaryDealerPositioningQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReservePrimaryDealerPositioningData]:
+        """Transform the data."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_federal_reserve.utils.primary_dealer_statistics import (
+            POSITION_SERIES_TO_FIELD,
+            POSITION_SERIES_TO_TITLE,
+        )
+        from pandas import DataFrame
+
+        df = DataFrame(data)
+        df = df.rename(columns={"keyid": "symbol", "asofdate": "date"})
+        df["name"] = df.symbol.map(
+            lambda x: POSITION_SERIES_TO_FIELD["dealer_position"].get(x)
+        )
+        df["title"] = df.symbol.map(lambda x: POSITION_SERIES_TO_TITLE.get(x))
+
+        return [
+            FederalReservePrimaryDealerPositioningData.model_validate(d)
+            for d in df.to_dict(orient="records")
+        ]

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/sofr.py

@@ -0,0 +1,108 @@
+"""Federal Reserve SOFR Model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.sofr import (
+    SOFRData,
+    SOFRQueryParams,
+)
+from openbb_core.provider.utils.errors import EmptyDataError
+from pydantic import field_validator
+
+
+class FederalReserveSOFRQueryParams(SOFRQueryParams):
+    """FederalReserve FED Query."""
+
+
+class FederalReserveSOFRData(SOFRData):
+    """FederalReserve FED Data."""
+
+    __alias_dict__ = {
+        "date": "effectiveDate",
+        "rate": "percentRate",
+        "percentile_1": "percentPercentile1",
+        "percentile_25": "percentPercentile25",
+        "percentile_75": "percentPercentile75",
+        "percentile_99": "percentPercentile99",
+        "volume": "volumeInBillions",
+    }
+
+    @field_validator(
+        "rate",
+        "target_range_upper",
+        "target_range_lower",
+        "percentile_1",
+        "percentile_25",
+        "percentile_75",
+        "percentile_99",
+        mode="before",
+        check_fields=False,
+    )
+    @classmethod
+    def normalize_percent(cls, v):
+        """Normalize percent."""
+        if v not in (None, "", "''", "NA"):
+            return float(v) / 100 if v != 0 else 0
+        return None
+
+
+class FederalReserveSOFRFetcher(
+    Fetcher[
+        FederalReserveSOFRQueryParams,
+        List[FederalReserveSOFRData],
+    ]
+):
+    """Federal Reserve Federal Funds Fetcher."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> FederalReserveSOFRQueryParams:
+        """Transform query."""
+        transformed_params = params.copy()
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = datetime(2018, 4, 2).date()
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return FederalReserveSOFRQueryParams(**transformed_params)
+
+    @staticmethod
+    async def aextract_data(
+        query: FederalReserveSOFRQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the raw data."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_core.provider.utils.helpers import amake_request
+
+        url = (
+            "https://markets.newyorkfed.org/api/rates/secured/sofr/search.json?"
+            + f"startDate={query.start_date}&endDate={query.end_date}"
+        )
+        results: List[Dict] = []
+        response = await amake_request(url, **kwargs)
+        results = response.get("refRates")  # type: ignore
+        if not results:
+            raise EmptyDataError()
+        return results
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveSOFRQueryParams,
+        data: List[Dict],
+        **kwargs: Any,
+    ) -> List[FederalReserveSOFRData]:
+        """Transform data."""
+        results: List[FederalReserveSOFRData] = []
+        for d in data.copy():
+            _ = d.pop("type", None)
+            _ = d.pop("footnoteId", None)
+            _ = d.pop("revisionIndicator", None)
+            results.append(FederalReserveSOFRData.model_validate(d))
+
+        return results

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/treasury_rates.py

@@ -0,0 +1,120 @@
+"""FederalReserve Treasury Rates Model."""
+
+# pylint: disable=unused-argument
+
+from datetime import datetime
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.treasury_rates import (
+    TreasuryRatesData,
+    TreasuryRatesQueryParams,
+)
+from pydantic import field_validator
+
+if TYPE_CHECKING:
+    from pandas import DataFrame  # pylint: disable=import-outside-toplevel
+
+maturities = [
+    "month_1",
+    "month_3",
+    "month_6",
+    "year_1",
+    "year_2",
+    "year_3",
+    "year_5",
+    "year_7",
+    "year_10",
+    "year_20",
+    "year_30",
+]
+
+
+class FederalReserveTreasuryRatesQueryParams(TreasuryRatesQueryParams):
+    """FederalReserve Treasury Rates Query."""
+
+
+class FederalReserveTreasuryRatesData(TreasuryRatesData):
+    """FederalReserve Treasury Rates Data."""
+
+    @field_validator("date", mode="before", check_fields=False)
+    @classmethod
+    def date_validate(cls, v):  # pylint: disable=E0213
+        """Return the date as a datetime object."""
+        return datetime.strptime(v, "%Y-%m-%d")
+
+
+class FederalReserveTreasuryRatesFetcher(
+    Fetcher[
+        FederalReserveTreasuryRatesQueryParams,
+        List[FederalReserveTreasuryRatesData],
+    ]
+):
+    """Transform the query, extract and transform the data from the FederalReserve endpoints."""
+
+    @staticmethod
+    def transform_query(
+        params: Dict[str, Any]
+    ) -> FederalReserveTreasuryRatesQueryParams:
+        """Transform the query params. Start and end dates are set to a 90 day interval."""
+        # pylint: disable=import-outside-toplevel
+        from datetime import timedelta
+
+        transformed_params = params
+
+        now = datetime.now().date()
+        if params.get("start_date") is None:
+            transformed_params["start_date"] = now - timedelta(days=365)
+
+        if params.get("end_date") is None:
+            transformed_params["end_date"] = now
+
+        return FederalReserveTreasuryRatesQueryParams(**transformed_params)
+
+    @staticmethod
+    def extract_data(
+        query: FederalReserveTreasuryRatesQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> "DataFrame":
+        """Return the raw data from the FederalReserve endpoint."""
+        # pylint: disable=import-outside-toplevel
+        from io import BytesIO  # noqa
+        from openbb_core.provider.utils.helpers import make_request  # noqa
+        from numpy import nan  # noqa
+        from pandas import DataFrame, read_csv  # noqa
+
+        url = (
+            "https://www.federalreserve.gov/datadownload/Output.aspx?"
+            + "rel=H15&series=bf17364827e38702b42a58cf8eaa3f78&lastobs=&"
+            + "from=&to=&filetype=csv&label=include&layout=seriescolumn&type=package"
+        )
+
+        r = make_request(url, **kwargs)
+
+        df = read_csv(BytesIO(r.content), header=5, index_col=None, parse_dates=True)
+        df.columns = ["date"] + maturities
+        df = df.set_index("date").replace("ND", nan)
+
+        return df.dropna(axis=0, how="all").reset_index()
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveTreasuryRatesQueryParams, data: "DataFrame", **kwargs: Any
+    ) -> List[FederalReserveTreasuryRatesData]:
+        """Return the transformed data."""
+        # pylint: disable=import-outside-toplevel
+        from pandas import to_datetime
+
+        df = data.copy()
+        df = df[
+            (to_datetime(df.date) >= to_datetime(query.start_date))  # type: ignore
+            & (to_datetime(df.date) <= to_datetime(query.end_date))  # type: ignore
+        ]
+        for col in maturities:
+            df[col] = df[col].astype(float) / 100
+        df = df.fillna("N/A").replace("N/A", None)
+        return [
+            FederalReserveTreasuryRatesData.model_validate(d)
+            for d in df.to_dict("records")
+        ]

openbb_platform/providers/federal_reserve/openbb_federal_reserve/models/yield_curve.py

@@ -0,0 +1,117 @@
+"""FederalReserve Yield Curve Model."""
+
+# pylint: disable=unused-argument
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.yield_curve import (
+    YieldCurveData,
+    YieldCurveQueryParams,
+)
+
+if TYPE_CHECKING:
+    from pandas import DataFrame  # pylint: disable=import-outside-toplevel
+
+maturities = [
+    "month_1",
+    "month_3",
+    "month_6",
+    "year_1",
+    "year_2",
+    "year_3",
+    "year_5",
+    "year_7",
+    "year_10",
+    "year_20",
+    "year_30",
+]
+
+
+class FederalReserveYieldCurveQueryParams(YieldCurveQueryParams):
+    """FederalReserve Yield Curve Query."""
+
+    __json_schema_extra__ = {"date": {"multiple_items_allowed": True}}
+
+
+class FederalReserveYieldCurveData(YieldCurveData):
+    """FederalReserve Yield Curve Data."""
+
+
+class FederalReserveYieldCurveFetcher(
+    Fetcher[
+        FederalReserveYieldCurveQueryParams,
+        List[FederalReserveYieldCurveData],
+    ]
+):
+    """FederalReserve Yield Curve Fetcher."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> FederalReserveYieldCurveQueryParams:
+        """Transform the query params."""
+        return FederalReserveYieldCurveQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: FederalReserveYieldCurveQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> "DataFrame":
+        """Extract the raw data."""
+        # pylint: disable=import-outside-toplevel
+        from io import BytesIO  # noqa
+        from numpy import nan  # noqa
+        from openbb_core.provider.utils.helpers import make_request  # noqa
+        from pandas import read_csv  # noqa
+
+        url = (
+            "https://www.federalreserve.gov/datadownload/Output.aspx?"
+            + "rel=H15&series=bf17364827e38702b42a58cf8eaa3f78&lastobs=&"
+            + "from=&to=&filetype=csv&label=include&layout=seriescolumn&type=package"
+        )
+        r = make_request(url, **kwargs)
+        df = read_csv(BytesIO(r.content), header=5, index_col=None, parse_dates=True)
+        df.columns = ["date"] + maturities
+        df = df.set_index("date").replace("ND", nan)
+
+        return df.dropna(axis=0, how="all").reset_index()
+
+    @staticmethod
+    def transform_data(
+        query: FederalReserveYieldCurveQueryParams, data: "DataFrame", **kwargs: Any
+    ) -> List[FederalReserveYieldCurveData]:
+        """Return the transformed data."""
+        # pylint: disable=import-outside-toplevel
+        from pandas import Categorical, DatetimeIndex
+
+        df = data.copy()
+        df.set_index("date", inplace=True)
+        dates = query.date.split(",") if query.date else [df.index.max()]
+        df.index = DatetimeIndex(df.index)
+        dates_list = DatetimeIndex(dates)
+        df.columns.name = "maturity"
+
+        # Find the nearest date in the DataFrame to each date in dates_list
+        nearest_dates = [df.index.asof(date) for date in dates_list]
+
+        # Filter for only the nearest dates
+        df = df[df.index.isin(nearest_dates)]
+
+        df = df.fillna("N/A").replace("N/A", None)
+
+        # Flatten the DataFrame
+        flattened_data = df.reset_index().melt(
+            id_vars="date", var_name="maturity", value_name="rate"
+        )
+        flattened_data = flattened_data.sort_values("date")
+        flattened_data["maturity"] = Categorical(
+            flattened_data["maturity"], categories=maturities, ordered=True
+        )
+        flattened_data["rate"] = flattened_data["rate"].astype(float) / 100
+        flattened_data = flattened_data.sort_values(
+            by=["date", "maturity"]
+        ).reset_index(drop=True)
+        flattened_data.loc[:, "date"] = flattened_data["date"].dt.strftime("%Y-%m-%d")
+        records = flattened_data.to_dict(orient="records")
+
+        return [FederalReserveYieldCurveData.model_validate(d) for d in records]

openbb_platform/providers/federal_reserve/openbb_federal_reserve/utils/fomc_documents.py

@@ -0,0 +1,195 @@
+"""FOMC document and release utilities."""
+
+from functools import lru_cache
+from typing import Literal, Optional
+
+FomcDocumentType = Literal[
+    "all",
+    "monetary_policy",
+    "minutes",
+    "projections",
+    "materials",
+    "press_release",
+    "press_conference",
+    "conference_call",
+    "agenda",
+    "transcript",
+    "speaker_key",
+    "beige_book",
+    "teal_book",
+    "green_book",
+    "blue_book",
+    "red_book",
+]
+
+
+@lru_cache(maxsize=1)
+def load_historical_fomc_documents() -> list:
+    """Load historical FOMC documents map from the static assets."""
+    # pylint: disable=import-outside-toplevel
+    import json
+
+    historical_docs: list = []
+    historical_docs_path = __file__.replace(
+        "utils/fomc_documents.py", "assets/historical_releases.json"
+    )
+    with open(historical_docs_path, encoding="utf-8") as file:
+        historical_docs = json.load(file)
+
+    return historical_docs
+
+
+@lru_cache(maxsize=1)
+def get_current_fomc_documents() -> list:
+    """
+    Get the current FOMC documents from https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm.
+
+    Returns
+    -------
+    list
+        A list of dictionaries containing the FOMC documents.
+        Each dictionary contains the following:
+        - date: str
+            The date of the document, formatted as YYYY-MM-DD.
+        - doc_type: str
+            The type of the document.
+        - doc_format: str
+            The format of the document.
+        - url: str
+            The URL of the document
+    """
+    # pylint: disable=import-outside-toplevel
+    import re  # noqa
+    from bs4 import BeautifulSoup
+    from openbb_core.provider.utils.helpers import make_request
+
+    url = "https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm"
+    response = make_request(url, method="GET")
+    soup = BeautifulSoup(response.content, "html.parser")
+    data_releases: list = []
+
+    for link in soup.find_all("a"):
+        url = link.get("href", "")
+
+        if "/newsevents/pressreleases" in url:
+            continue
+
+        file_url = f"https://www.federalreserve.gov{url}"
+        date = file_url.rsplit("/", 1)[-1].split(".")[0]
+        date_match = re.search(r"(\d{4})(\d{2})(\d{2})", date)
+        if date_match:
+            new_date = (
+                f"{date_match.group(1)}-{date_match.group(2)}-{date_match.group(3)}"
+            )
+            file_type = ""
+            if "files" in url and "monetary" in date:
+                file_type = "monetary_policy"
+            if "fomcproj" in date:
+                file_type = "projections"
+            if "fomcminutes" in date:
+                file_type = "minutes"
+            if "fomcpresconf" in date:
+                file_type = "press_conference"
+
+            file_format = file_url.rsplit(".", maxsplit=1)[-1]
+            data_releases.append(
+                {
+                    "date": new_date,
+                    "doc_type": file_type,
+                    "doc_format": file_format,
+                    "url": file_url,
+                }
+            )
+    data_releases = sorted(data_releases, key=lambda x: x["date"], reverse=True)
+
+    return data_releases
+
+
+@lru_cache(maxsize=32)
+def get_fomc_documents_by_year(
+    year: Optional[int] = None,
+    document_type: Optional[FomcDocumentType] = None,
+    pdf_only: bool = False,
+) -> list[dict]:
+    """
+    Get a list of FOMC documents by year and document type.
+
+    Parameters
+    ----------
+    year : Optional[int]
+        The year of the FOMC documents to retrieve. If None, all years since 1959 are returned.
+    document_type : Optional[FomcDocumentType]
+        The type of FOMC document to retrieve. If None, all document types are returned.
+        Valid document types are:
+        - all
+        - monetary_policy
+        - minutes
+        - projections
+        - materials
+        - press_release
+        - press_conference
+        - conference_call
+        - agenda
+        - transcript
+        - speaker_key
+        - beige_book
+        - teal_book
+        - green_book
+        - blue_book
+        - red_book
+    pdf_only : bool
+        Whether to return with only the PDF documents. Default is False.
+
+    Returns
+    -------
+    list[dict]
+        A list of dictionaries mapping FOMC documents to URLs.
+        Each dictionary contains the following:
+        - date: str
+            The date of the document, formatted as YYYY-MM-DD.
+        - doc_type: str
+            The type of the document.
+        - doc_format: str
+            The format of the document.
+        - url: str
+            The URL of the document
+    """
+    filtered_docs: list[dict] = []
+    choice_types = list(getattr(FomcDocumentType, "__args__", ()))
+
+    if year and year < 1959:
+        raise ValueError("Year must be from 1959.")
+
+    if year and isinstance(year, str):
+        year = int(year) if year.isdigit() else 0
+        if year == 0:
+            raise ValueError("Year must be an integer.")
+
+    if not document_type:
+        document_type = "all"
+
+    if document_type not in choice_types:
+        raise ValueError(
+            f"Invalid document type. Must be one of: {', '.join(choice_types)}"
+        )
+
+    if year:
+        docs = (
+            get_current_fomc_documents()
+            if year > 2019
+            else load_historical_fomc_documents()
+        )
+    else:
+        current_docs = get_current_fomc_documents()
+        historical_docs = load_historical_fomc_documents()
+        docs = current_docs + historical_docs
+
+    for doc in docs:
+        doc_year = int(doc["date"].split("-")[0])
+        if year and doc_year != year:
+            continue
+        if pdf_only is True and doc["doc_format"] != "pdf":
+            continue
+        if document_type in ("all", doc["doc_type"]):
+            filtered_docs.append(doc)
+    return filtered_docs

openbb_platform/providers/federal_reserve/openbb_federal_reserve/utils/ny_fed_api.py

@@ -0,0 +1,641 @@
+"""NY Federal Reserve API Utilities."""
+
+# pylint: disable=too-many-arguments,too-many-locals,unused-argument
+
+from typing import Dict, List, Literal, Optional, Union
+
+from openbb_core.app.model.abstract.error import OpenBBError
+from openbb_core.provider.utils.errors import EmptyDataError
+from openbb_core.provider.utils.helpers import amake_request
+from pandas import DataFrame, DatetimeIndex, to_datetime
+
+BASE_URL = "https://markets.newyorkfed.org/api"
+OPERATION_STATUS = ["announcements", "results"]
+DETAILS = ["summary", "details"]
+GUIDE_SHEET_TYPES = ["si", "wi", "fs"]
+AMBS_OPERATION_TYPES = ["all", "purchases", "sales", "roll", "swap"]
+AMBS_SECURITIES = {
+    None: "",
+    "basket": "Basket",
+    "coupon_swap": "Coupon%20Swap",
+    "dollar_roll": "Dollar%20Roll",
+    "specified_pool": "Specified%20Pool",
+    "tba": "TBA",
+}
+FXS_OPERATION_TYPES = ["all", "usdollar", "nonusdollar"]
+FXS_DATE_TYPES = ["all", "trade", "maturity"]
+REFERENCE_RATE_TYPES = ["rate", "volume"]
+SECURED_RATE_TYPES = ["tgcr", "bgcr", "sofr", "sofrai"]
+UNSECURED_RATE_TYPES = ["effr", "obfr"]
+REPO_OPERATION_TYPES = ["all", "repo", "reverserepo"]
+REPO_OPERATION_METHODS = ["all", "fixed", "single", "multiple"]
+REPO_SECURITY_TYPES = ["mbs", "agency", "tsy", "srf"]
+REPO_TERM_TYPES = ["overnight", "term"]
+LENDING_OPERATION_TYPES = ["all", "seclending", "extensions"]
+AGENCY_HOLDING_TYPES = {
+    "all": "all",
+    "agency_debts": "agency%20debts",
+    "mbs": "mbs",
+    "cmbs": "cmbs",
+}
+TREASURY_HOLDING_TYPES = ["all", "bills", "notesbonds", "frn", "tips"]
+TREASURY_OPERATION_TYPES = ["all", "purchases", "sales"]
+TREASURY_STATUS_TYPES = ["announcements", "results", "operations"]
+TREASURY_SECURITY_TYPE = ["agency", "treasury"]
+CategoryChoices = Literal[
+    "agency_mbs_operations",
+    "central_bank_liquidity_swaps_operations",
+    "guide_sheets",
+    "primary_dealer_statistics",
+    "primary_dealer_market_share",
+    "reference_rates",
+    "repo_and_reverse_repo_operations",
+    "securities_lending_operations",
+    "soma_holdings",
+    "treasury_securities_operations",
+]
+HoldingTypes = Literal[
+    "all_agency",
+    "agency_debts",
+    "mbs",
+    "cmbs",
+    "all_treasury",
+    "bills",
+    "notesbonds",
+    "frn",
+    "tips",
+]
+HOLDING_TYPE_CHOICES = [
+    "all_agency",
+    "agency_debts",
+    "mbs",
+    "cmbs",
+    "all_treasury",
+    "bills",
+    "notesbonds",
+    "frn",
+    "tips",
+]
+
+
+def _get_endpoints(
+    category: Union[CategoryChoices, None] = None,
+    start_date: Optional[str] = "",
+    end_date: Optional[str] = "",
+    date: Optional[str] = "2022-02-22",
+    details: Optional[str] = "details",
+    n_operations: Optional[int] = 90,
+    operation_status: Optional[str] = "results",
+    ambs_operation: Optional[str] = "all",
+    ambs_security: Optional[str] = "",
+    fxs_operation_type: Optional[str] = "all",
+    fxs_date_type: Optional[str] = "",
+    fxs_counterparties: Optional[str] = "",
+    guide_sheet_types: Optional[str] = "si",
+    is_previous: Optional[bool] = False,
+    pd_seriesbreak: Optional[str] = "SBN2022",
+    pd_timeseries: Optional[str] = "PDSOOS-ABSTOT",
+    pd_asof_date: Optional[str] = "2023-03-01",
+    rate_type: Optional[str] = "",
+    secured_type: Optional[str] = "sofr",
+    unsecured_type: Optional[str] = "effr",
+    repo_security_type: Optional[str] = "all",
+    repo_operation_type: Optional[str] = "all",
+    repo_operation_method: Optional[str] = "all",
+    repo_term: Optional[str] = "",
+    lending_operation: Optional[str] = "all",
+    cusips: Optional[str] = "",
+    description: Optional[str] = "",
+    agency_holding_type: Optional[str] = "all",
+    treasury_holding_type: Optional[str] = "all",
+    treasury_operation: Optional[str] = "all",
+    treasury_status: Optional[str] = "results",
+    treasury_security_type: Optional[str] = "",
+) -> Dict:
+    """Generate URLs to the all, or a category of, endpoints.
+
+    This function is not intended to be used directly.
+    """
+    is_latest: str = "latest"
+    if ambs_security:
+        ambs_security = AMBS_SECURITIES[ambs_security]
+
+    if is_previous:
+        is_latest = "previous" if is_previous else "latest"
+
+    end_points = {
+        "agency_mbs_operations": {
+            "latest": BASE_URL + "/ambs/"
+            f"{ambs_operation}"
+            "/"
+            f"{operation_status}"
+            "/"
+            f"{details}"
+            "/latest.json",
+            "previous": BASE_URL + "/ambs/"
+            f"{ambs_operation}"
+            "/"
+            f"{operation_status}"
+            "/"
+            f"{details}"
+            "/previous.json",
+            "last_two_weeks": BASE_URL + "/ambs/"
+            f"{ambs_operation}"
+            "/"
+            f"{operation_status}"
+            "/"
+            f"{details}"
+            "/lastTwoWeeks.json",
+            "last": BASE_URL + "/ambs/"
+            f"{ambs_operation}"
+            "/"
+            f"{operation_status}"
+            "/"
+            f"{details}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "search": BASE_URL + "/ambs/"
+            f"{ambs_operation}"
+            "/"
+            f"{operation_status}"
+            "/"
+            f"{details}"
+            "/search.json?"
+            "securities="
+            f"{ambs_security}"
+            "&desc="
+            f"{description}"
+            "&cusip="
+            f"{cusips}"
+            "&startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}",
+        },
+        "central_bank_liquidty_swaps_operations": {
+            "latest": BASE_URL + "/fxs/" f"{fxs_operation_type}" "/latest.json",
+            "last": BASE_URL + "/fxs/"
+            f"{fxs_operation_type}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "search": BASE_URL + "/fxs/"
+            f"{fxs_operation_type}"
+            "/search.json"
+            "?startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}"
+            "&dateType="
+            f"{fxs_date_type}"
+            "&counterparties="
+            f"{fxs_counterparties}",
+            "counterparties": BASE_URL + "/fxs/list/counterparties.json",
+        },
+        "guide_sheets": BASE_URL + "/guidesheets/"
+        f"{guide_sheet_types}"
+        "/"
+        f"{is_latest}"
+        ".json",
+        "primary_dealer_statistics": {
+            "latest": BASE_URL + "/pd/latest/" f"{pd_seriesbreak}" ".json",
+            "all_timeseries": BASE_URL + "/pd/get/all/timeseries.csv",
+            "list_descriptions": BASE_URL + "/pd/list/timeseries.json",
+            "list_asof": BASE_URL + "/pd/list/asof.json",
+            "list_seriesbreaks": BASE_URL + "/pd/list/seriesbreaks.json",
+            "get_asof": BASE_URL + "/pd/get/asof/" f"{pd_asof_date}" ".json",
+            "get_timeseries": BASE_URL + "/pd/get/" f"{pd_timeseries}" ".json",
+            "get_timeseries_seriesbreak": BASE_URL + "/pd/get/"
+            f"{pd_seriesbreak}"
+            "/timeseries/"
+            f"{pd_timeseries}"
+            ".json",
+        },
+        "primary_dealer_market_share": {
+            "quarterly": BASE_URL + "/marketshare/qtrly/latest.xlsx",
+            "ytd": BASE_URL + "/marketshare/ytd/latest.xlsx",
+        },
+        "reference_rates": {
+            "latest": BASE_URL + "/rates/all/latest.json",
+            "search": BASE_URL + "/rates/all/search.json?"
+            "startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}"
+            "&type="
+            f"{rate_type}",
+            "latest_secured": BASE_URL + "/rates/secured/all/latest.json",
+            "latest_unsecured": BASE_URL + "/rates/unsecured/all/latest.json",
+            "last_secured": BASE_URL + "/rates/secured/"
+            f"{secured_type}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "last_unsecured": BASE_URL + "/rates/unsecured/"
+            f"{unsecured_type}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+        },
+        "repo_and_reverse_repo_operations": {
+            "latest": BASE_URL + "/rp/"
+            f"{repo_operation_type}"
+            "/"
+            f"{repo_operation_method}"
+            "/"
+            f"{operation_status}"
+            "/latest.json",
+            "last_two_weeks": BASE_URL + "/rp/"
+            f"{repo_operation_type}"
+            "/"
+            f"{repo_operation_method}"
+            "/"
+            f"{operation_status}"
+            "/lastTwoWeeks.json",
+            "last": BASE_URL + "/rp/"
+            f"{repo_operation_type}"
+            "/"
+            f"{repo_operation_method}"
+            "/"
+            f"{operation_status}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "search": BASE_URL + "/rp/results/search.json?"
+            "startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}"
+            "&operationTypes="
+            f"{repo_operation_type}"
+            "&method="
+            f"{repo_operation_method}"
+            "&securityType="
+            f"{repo_security_type}"
+            "&term="
+            f"{repo_term}",
+            "propositions": BASE_URL + "/rp/reverserepo/propositions/search.json?"
+            "startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}",
+        },
+        "securities_lending_operations": {
+            "latest": BASE_URL + "/seclending/"
+            f"{lending_operation}"
+            "/results/"
+            f"{details}"
+            "/latest.json",
+            "last_two_weeks": BASE_URL + "/seclending/"
+            f"{lending_operation}"
+            "/results/"
+            f"{details}"
+            "/lastTwoWeeks.json",
+            "last": BASE_URL + "/seclending/"
+            f"{lending_operation}"
+            "/results/"
+            f"{details}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "search": BASE_URL + "/seclending/"
+            f"{lending_operation}"
+            "/results/"
+            f"{details}"
+            "/search.json"
+            "?startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}"
+            "&cusips="
+            f"{cusips}"
+            "&descriptions="
+            f"{description}",
+        },
+        "soma_holdings": {
+            "summary": BASE_URL + "/soma/summary.json",
+            "release_log": BASE_URL + "/soma/agency/get/release_log.json",
+            "list_as_of": BASE_URL + "/soma/asofdates/list.json",
+            "get_as_of": BASE_URL + "/soma/agency/get/asof/" f"{date}" ".json",
+            "get_cusip": BASE_URL + "/soma/agency/get/cusip/" f"{cusips}" ".json",
+            "get_holding_type": BASE_URL + "/soma/agency/get/"
+            f"{agency_holding_type}"
+            "/asof/"
+            f"{date}"
+            ".json",
+            "agency_debts": BASE_URL + "/soma/agency/wam/agency%20debts/asof/"
+            f"{date}"
+            ".json",
+            "list_release_dates": BASE_URL + "/soma/tsy/get/release_log.json",
+            "get_treasury_as_of": BASE_URL + "/soma/tsy/get/asof/" f"{date}" ".json",
+            "get_treasury_cusip": BASE_URL + "/soma/tsy/get/cusip/" f"{cusips}" ".json",
+            "get_treasury_holding_type": BASE_URL + "/soma/tsy/get/"
+            f"{treasury_holding_type}"
+            "/asof/"
+            f"{date}"
+            ".json",
+            "get_treasury_debts": BASE_URL + "/soma/tsy/wam/"
+            f"{treasury_holding_type}"
+            "/asof/"
+            f"{date}"
+            ".json",
+            "get_treasury_monthly": BASE_URL + "/soma/tsy/get/monthly.json",
+        },
+        "treasury_securities_operations": {
+            "current": BASE_URL + "/tsy/"
+            f"{treasury_operation}"
+            "/"
+            f"{treasury_status}"
+            "/"
+            f"{details}"
+            "/latest.json",
+            "last_two_weeks": BASE_URL + "/tsy/"
+            f"{treasury_operation}"
+            "/results/"
+            f"{details}"
+            "/lastTwoWeeks.json",
+            "last": BASE_URL + "/tsy/"
+            f"{treasury_operation}"
+            "/results/"
+            f"{details}"
+            "/last/"
+            f"{n_operations}"
+            ".json",
+            "search": BASE_URL + "/tsy/"
+            f"{treasury_operation}"
+            "/results/"
+            f"{details}"
+            "/search.json?"
+            "startDate="
+            f"{start_date}"
+            "&endDate="
+            f"{end_date}"
+            "&securityType="
+            f"{treasury_security_type}"
+            "&cusip="
+            f"{cusips}"
+            "&desc="
+            f"{description}",
+        },
+    }
+    return end_points if category is None else end_points[category]  # type: ignore
+
+
+async def fetch_data(url: str) -> Dict:
+    """Fetch the JSON response from the API."""
+    try:
+        response = await amake_request(url)
+    except Exception as e:  # pylint: disable=broad-except
+        raise e from e
+    return response  # type: ignore
+
+
+def get_nearest_date(dates: List[str], target_date: str) -> str:
+    """Get the nearest date in the list of dates to the target date."""
+    df = DataFrame(dates, columns=["dates"])
+    df["dates"] = DatetimeIndex(df["dates"])
+    target_date = to_datetime(target_date)
+    differences = (df.dates - target_date).abs()
+    nearest_date_index = differences.argmin()
+    nearest_date = df.index[nearest_date_index]
+    return df.iloc[nearest_date]["dates"].strftime("%Y-%m-%d")
+
+
+class SomaHoldings:
+    """Wrapper for NY Fed's System Open Market Account endpoints.
+
+    All get methods are asynchronous.
+
+    Methods
+    -------
+    get_as_of_dates: Function for getting all valid as-of dates for SOMA data.
+        Returns: List
+    get_release_log: Function for getting the last three months of Agency release and as-of dates.
+        Returns: List[Dict]
+    get_summary: Function for getting historical weekly summaries by holding type.
+        Returns: List[Dict]
+    get_agency_holdings: Function for getting the latest agency holdings, or as of a single date.
+        Returns: List[Dict]
+    get_treasury_holdings: Function for getting the latest Treasury holdings, or as-of a single date.
+        Returns: List[Dict]
+
+    Examples
+    --------
+    >>> soma = SomaHoldings()
+
+    >>> logs = await soma.get_release_log()
+
+    >>> mbs = await soma.get_agency_holdings(holding_type = "mbs")
+
+    >>> monthly_holdings = await soma.get_treasury_holdings(monthly = True)
+    """
+
+    def __init__(self) -> None:
+        """Initialize the SomaHoldings class."""
+
+    def __repr__(self) -> str:
+        """Replace original repr with docstring."""
+        return str(self.__doc__)
+
+    async def get_as_of_dates(self) -> List:
+        """Get all valid as-of dates for SOMA operations."""
+        dates_url = _get_endpoints()["soma_holdings"]["list_as_of"]
+        dates_response = await fetch_data(dates_url)
+        dates = dates_response.get("soma", {}).get("asOfDates", [])
+        if not dates:
+            raise OpenBBError("Error requesting dates. Please try again later.")
+        return dates
+
+    async def get_release_log(
+        self,
+        treasury: bool = False,
+    ) -> List[Dict]:
+        """Return the last three months Agency Release and as-of dates.
+
+        Parameters
+        ----------
+        treasury: bool
+            If True, returns the last three months of Treasury release and as-of dates.
+
+        Returns
+        -------
+        List[Dict]: Dictionary of the release date and as-of dates.
+
+        Example
+        -------
+        >>> release_log = await SomaHoldings().get_release_log(treasury = True)
+        """
+        url = (
+            _get_endpoints()["soma_holdings"]["list_release_dates"]
+            if treasury is True
+            else _get_endpoints()["soma_holdings"]["release_log"]
+        )
+        response = await fetch_data(url)
+        release_log = response.get("soma", {}).get("dates", [])
+        if not release_log:
+            raise OpenBBError("No data found. Try again later.")
+
+        return release_log
+
+    async def get_summary(self) -> List[Dict]:
+        """Return historical weekly summary by holding type.
+
+        Returns
+        -------
+        List[Dict]: Historical weekly summary by holding type.
+
+        Example
+        -------
+        summary = await SomaHoldings().get_summary()
+        """
+        url = _get_endpoints()["soma_holdings"]["summary"]
+        response = await fetch_data(url)
+        summary = response.get("soma", {}).get("summary", [])
+        if not summary:
+            raise EmptyDataError(
+                "There was an error with the request and was returned empty."
+            )
+
+        return summary
+
+    async def get_agency_holdings(
+        self,
+        as_of: Optional[str] = None,
+        cusip: Optional[str] = None,
+        holding_type: Optional[str] = None,
+        wam: bool = False,
+    ) -> List[Dict]:
+        """Get the latest agency holdings, or as of a single date. Data is updated weekly.
+
+        Parameters
+        ----------
+        as_of: Optional[str]
+            The as-of date to get data for. Defaults to the latest.
+        cusip: Optional[str]
+            The CUSIP of the security to search for. This parameter takes priority over `holding_type`.
+        holding_type: Optional[str]
+            The holding type for which to retrieve. Choices are: ['all', 'agency debts', 'mbs', 'cmbs']
+        wam: Optional[bool]
+            Whether to return a single date weighted average maturity for Agency debt. Defaults to False.
+            This parameter takes priority over `holding_type` and `cusip`.
+
+        Returns
+        -------
+        List[Dict]: List of dictionaries with results.
+
+        Examples
+        --------
+        >>> holdings = await SomaHoldings().get_agency_holdings(holding_type = "cmbs")
+
+        >>> df = await SomaHoldings().get_agency_holdings(cusip = "3138LMCK7")
+
+        >>> wam = await SomaHoldings().get_agency_holdings(wam = True)
+        """
+        response: Dict = {}
+        url: str = ""
+        dates = await self.get_as_of_dates()
+        if as_of is not None:
+            as_of = get_nearest_date(dates, as_of)
+        if as_of is None:
+            as_of = dates[0]
+        if wam is True:
+            url = _get_endpoints(
+                date=as_of,
+            )[
+                "soma_holdings"
+            ]["agency_debts"]
+            response = await fetch_data(url)
+            return [response.get("soma", {})]
+        url = _get_endpoints(date=as_of)["soma_holdings"]["get_as_of"]
+        if holding_type is not None:
+            if holding_type not in AGENCY_HOLDING_TYPES:
+                raise OpenBBError(
+                    "Invalid choice. Choose from: ['all', 'agency debts', 'mbs', 'cmbs']"
+                )
+            url = _get_endpoints(
+                agency_holding_type=AGENCY_HOLDING_TYPES[holding_type], date=as_of
+            )["soma_holdings"]["get_holding_type"]
+        if cusip is not None:
+            url = _get_endpoints(cusips=cusip)["soma_holdings"]["get_cusip"]
+        response = await fetch_data(url)
+        holdings = response.get("soma", {}).get("holdings", [])
+        if not holdings:
+            raise EmptyDataError()
+
+        return holdings
+
+    async def get_treasury_holdings(
+        self,
+        as_of: Optional[str] = None,
+        cusip: Optional[str] = None,
+        holding_type: Optional[str] = None,
+        wam: Optional[bool] = False,
+        monthly: Optional[bool] = False,
+    ) -> List[Dict]:
+        """Get the latest Treasury holdings, or as of a single date.
+
+        Parameters
+        ----------
+        as_of: Optional[str]
+            The as-of date to get data for. Defaults to the latest.
+        cusip: Optional[str]
+            The CUSIP of the security to search for. This parameter takes priority over `monthly` and `holding_type`.
+        holding_type: Optional[str]
+            The holding type for which to retrieve. Choices are: ['all', 'bills', 'notesbonds', 'frn', 'tips']
+        wam: Optional[bool]
+            Whether to return a single date weighted average maturity for Agency debt. Defaults to False.
+            This parameter takes priority over `holding_type`, `cusip`, and `monthly`.
+        monthly: Optional[bool]
+            If true, returns historical data for all securities at a monthly interval.
+            This parameter takes priority over other parameters except `wam`.
+
+        Returns
+        -------
+        List[Dict]: List of dictionaries with results.
+
+        Examples
+        --------
+        >>> holdings = await SomaHoldings().get_treasury_holdings(holding_type = "tips")
+
+        >>> df = await SomaHoldings().get_treasury_holdings(cusip = "912810FH6")
+
+        >>> wam = await SomaHoldings().get_treasury_holdings(wam = True)
+
+        >>> monthly = await SomaHoldings().get_treasury_holdings(monthly = True, holding_type = "bills")
+        """
+        response: Dict = {}
+        url: str = ""
+        dates = await self.get_as_of_dates()
+        if as_of is not None:
+            as_of = get_nearest_date(dates, as_of)
+        if as_of is None:
+            as_of = dates[0]
+        if wam is True:
+            url = _get_endpoints(
+                date=as_of,
+            )[
+                "soma_holdings"
+            ]["get_treasury_debts"]
+            response = await fetch_data(url)
+            return [response.get("soma", {})]
+
+        if holding_type is not None:
+            if holding_type not in TREASURY_HOLDING_TYPES:
+                raise OpenBBError(
+                    f"Invalid choice. Choose from: {', '.join(TREASURY_HOLDING_TYPES)}"
+                )
+            url = _get_endpoints(treasury_holding_type=holding_type, date=as_of)[
+                "soma_holdings"
+            ]["get_treasury_holding_type"]
+        if monthly:
+            url = _get_endpoints()["soma_holdings"]["get_treasury_monthly"]
+        if cusip is not None:
+            url = _get_endpoints(cusips=cusip)["soma_holdings"]["get_treasury_cusip"]
+
+        response = await fetch_data(url)
+        holdings = response.get("soma", {}).get("holdings", [])
+        if not holdings:
+            raise EmptyDataError()
+
+        return holdings

openbb_platform/providers/federal_reserve/openbb_federal_reserve/utils/primary_dealer_statistics.py

@@ -0,0 +1,179 @@
+"""Primary Dealer Positioning Series IDs."""
+
+# pylint: disable=line-too-long
+# flake8: noqa
+
+FAILS_SERIES_TO_TITLE = {
+    "PDFTD-CS": "FTD Corporate Securities",
+    "PDFTR-CS": "FTR Corporate Securities",
+    "PDFASCFDA": "FTD Corporate Securities",
+    "PDFASCFRA": "FTR Corporate Securities",
+    "PDFTD-FGEM": "FTD Agency and GSE Securities (Ex-MBS)",
+    "PDFTR-FGEM": "FTR Agency and GSE Securities (Ex-MBS)",
+    "PDFASFAFDA": "FTD Agency and GSE Securities (Ex-MBS)",
+    "PDFASFAFRA": "FTR Agency and GSE Securities (Ex-MBS)",
+    "PDFTD-FGM": "FTD Agency and GSE MBS",
+    "PDFTR-FGM": "FTR Agency and GSE MBS",
+    "PDFTD-OM": "FTD Other MBS",
+    "PDFTR-OM": "FTR Other MBS",
+    "PDFASMBFDA": "FTD MBS",
+    "PDFASMBFRA": "FTR MBS",
+    "PDFTD-UST": "FTD TIPS",
+    "PDFTR-UST": "FTR TIPS",
+    "PDFTD-USTET": "FTD Treasury Securities (Ex-TIPS)",
+    "PDFTR-USTET": "FTR Treasury Securities (Ex-TIPS)",
+    "PDFASUFRA": "FTR Treasury Securities",
+    "PDFASUFDA": "FTD Treasury Securities",
+}
+
+
+POSITION_SERIES_TO_TITLE = {
+    "PDPOSGS-B": "BILLS (EX. TIPS): DEALER POSITION - LONG. - BILLS (EX. TIPS): DEALER POSITION - SHORT",
+    "PDPOSGSC-L2": "TREASURIES (EX. TIPS) COUPONS DUE IN LESS THAN OR EQUAL TO 2 YEARS: DEALER POSITION - NET",
+    "PDPOSGSC-G2L3": "TREASURIES (EX. TIPS) COUPONS DUE IN MORE THAN 2 YEARS BUT LESS THAN OR EQUAL TO 3 YEARS: DEALER POSITION - NET",
+    "PDPOSGSC-G3L6": "TREASURIES (EX. TIPS) COUPONS DUE IN MORE THAN 3 YEARS BUT LESS THAN OR EQUAL TO 6 YEARS: DEALER POSITION - NET",
+    "PDPOSGSC-G6L7": "TREASURIES (EX. TIPS) COUPONS DUE IN MORE THAN 6 YEARS BUT LESS THAN OR EQUAL TO 7 YEARS: DEALER POSITION - NET",
+    "PDPOSGSC-G7L11": "TREASURIES (EX. TIPS) COUPONS DUE IN MORE THAN 7 YEARS BUT LESS THAN OR EQUAL TO 11 YEARS: DEALER POSITION - NET",
+    "PDPOSGSC-G11L21": "TREASURIES (EX. TIPS): COUPONS DUE IN MORE THAN 11 YEARS BUT LESS THAN OR EQUAL TO 21 YEARS: OUTRIGHT POSITIONS - NET",
+    "PDPOSGSC-G21": "TREASURIES (EX. TIPS): COUPONS DUE IN MORE THAN 21 YEARS: OUTRIGHT POSITIONS - NET",
+    "PDPOSTIPS-L2": "TIPS DUE IN LESS THAN OR EQUAL TO 2 YEARS: DEALER POSITION - NET",
+    "PDPOSTIPS-G2": "TIPS DUE IN MORE THAN 2 YEARS BUT LESS THAN OR EQUAL TO 6 YEARS: DEALER POSITION - NET",
+    "PDPOSTIPS-G6L11": "TIPS DUE IN MORE THAN 6 YEARS BUT LESS THAN OR EQUAL TO 11 YEARS: DEALER POSITION - NET",
+    "PDPOSTIPS-G11": "TIPS DUE IN MORE THAN 11 YEARS: DEALER POSITION - NET",
+    "PDPOSGS-BFRN": "FLOATING RATE NOTES: DEALER POSITION - NET",
+    "PDPOSFGS-C": "AGENCY AND GSE (EX. MBS) - COUPONS: DEALER POSITION - NET",
+    "PDPOSFGS-DN": "AGENCY AND GSE (EX. MBS) - DISCOUNT NOTES: DEALER POSITION - NET",
+    "PDPOSMBSFGS-TBA": "MBS: FEDERAL AGENCY AND GSE MBS: TBAs - OUTRIGHT POSITIONS - NET",
+    "PDPOSMBSFGS-OR": "MBS - ALL OTHER FEDERAL AGENCY AND GSE RESIDENTIAL MBS: DEALER POSITION - NET",
+    "PDPOSMBSFGS-ST": "MBS: FEDERAL AGENCY AND GSE MBS: SPECIFIED POOLS - OUTRIGHT POSITIONS - NET",
+    "PDPOSMBSNA-R": "MBS - NON-AGENCY RESIDENTIAL MBS: DEALER POSITION - NET",
+    "PDPOSMBSFGS-C": "MBS - FEDERAL AGENCY AND GSE CMBS: DEALER POSITION - NET",
+    "PDPOSMBSNA-O": "MBS - NON-AGENCY OTHER CMBS: DEALER POSITION - NET",
+    "PDPOSSMGO-L13": "STATE AND MUNICIPAL GOVERNMENT OBLIGATIONS DUE IN LESS THAN OR EQUAL TO 13 MONTHS: DEALER POSITION - NET",
+    "PDPOSSMGO-G13": "STATE AND MUNICIPAL GOVERNMENT OBLIGATIONS DUE IN MORE THAN 13 MONTHS BUT LESS THAN OR EQUAL TO 5 YEARS: DEALER POSITION - NET",
+    "PDPOSSMGO-G5L10": "STATE AND MUNICIPAL GOVERNMENT OBLIGATIONS DUE IN MORE THAN 5 YEARS BUT LESS THAN OR EQUAL TO 10 YEARS: DEALER POSITION - NET",
+    "PDPOSSMGO-G10": "STATE AND MUNICIPAL GOVERNMENT OBLIGATIONS DUE IN MORE THAN 10 YEARS: DEALER POSITION - NET",
+    "PDPOSCSCP": "COMMERCIAL PAPER: DEALER POSITION - NET",
+    "PDPOSCSBND-L13": "CORPORATE SECURITIES: INVESTMENT GRADE BONDS, NOTES AND DEBENTURES DUE IN LESS THAN OR EQUAL TO 13 MONTHS: DEALER POSITION - NET",
+    "PDPOSCSBND-G13": "CORPORATE SECURITIES: INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 13 MONTHS BUT LESS THAN OR EQUAL TO 5 YEARS: DEALER POSITION - NET",
+    "PDPOSCSBND-G5L10": "CORPORATE SECURITIES INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 5 YEARS BUT LESS THAN OR EQUAL TO 10 YEARS: DEALER POSITION - NET",
+    "PDPOSCSBND-G10": "CORPORATE SECURITIES INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 10 YEARS: DEALER POSITION - NET",
+    "PDPOSCSBND-BELL13": "CORPORATE SECURITIES BELOW INVESTMENT GRADE DUE IN LESS THAN OR EQUAL TO 13 MONTHS: DEALER POSITION - NET",
+    "PDPOSCSBND-BELG13": "CORPORATE SECURITIES BELOW INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 13 MONTHS BUT LESS THAN OR EQUAL TO 5 YEARS: DEALER POSITION - NET",
+    "PDPOSCSBND-BELG5L10": "CORPORATE SECURITIES BELOW INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 5 YEARS BUT LESS THAN OR EQUAL TO 10 YEARS: DEALER POSITION - NET",
+    "PDPOSCSBND-BELG10": "CORPORATE SECURITIES BELOW INVESTMENT GRADE BONDS NOTES AND DEBENTURES DUE IN MORE THAN 10 YEARS: DEALER POSITION - NET",
+    "PDPOSABS-ALB": "AUTOMOBILE LOAN-BACKED SECURITIES: DEALER POSITION - NET",
+    "PDPOSABS-CCB": "CREDIT CARD-BACKED SECURITIES: DEALER POSITION - NET",
+    "PDPOSABS-SLB": "STUDENT LOAN-BACKED SECURITIES: DEALER POSITION - NET",
+    "PDPOSABS-OAB": "OTHER DEALER POSITION - NET",
+}
+
+POSITION_SERIES_TO_FIELD = {
+    "dealer_position": {
+        "PDPOSGS-B": "bills",
+        "PDPOSGSC-L2": "coupons_lte_2_years",
+        "PDPOSGSC-G2L3": "coupons_gt_2_years_lt_3_years",
+        "PDPOSGSC-G3L6": "coupons_gt_3_years_lt_6_years",
+        "PDPOSGSC-G6L7": "coupons_gt_6_years_lt_7_years",
+        "PDPOSGSC-G7L11": "coupons_gt_7_years_lt_11_years",
+        "PDPOSGSC-G11L21": "coupons_gt_11_years_lt_21_years",
+        "PDPOSGSC-G21": "coupons_gt_21_years",
+        "PDPOSTIPS-L2": "tips_lt_2_years",
+        "PDPOSTIPS-G2": "tips_gt_2_years_lt_6_years",
+        "PDPOSTIPS-G6L11": "tips_gt_6_years_lt_11_years",
+        "PDPOSTIPS-G11": "tips_gt_11_years",
+        "PDPOSGS-BFRN": "floating_rate_notes",
+        "PDPOSFGS-DN": "discount_notes",
+        "PDPOSFGS-C": "coupons_agency",
+        "PDPOSMBSFGS-TBA": "mbs_agency_and_gse_tba",
+        "PDPOSMBSFGS-OR": "mbs_agency_and_gse_other_residential",
+        "PDPOSMBSFGS-ST": "mbs_agency_and_gse_specified_pools",
+        "PDPOSMBSNA-R": "mbs_non_agency_residential",
+        "PDPOSMBSFGS-C": "cmbs_agency_and_gse",
+        "PDPOSMBSNA-O": "cmbs_non_agency",
+        "PDPOSSMGO-L13": "municipal_lt_13_months",
+        "PDPOSSMGO-G13": "municipal_gt_13_months_lt_5_years",
+        "PDPOSSMGO-G5L10": "municipal_gt_5_years_lt_10_years",
+        "PDPOSSMGO-G10": "municipal_gt_10_years",
+        "PDPOSCSCP": "commercial_paper",
+        "PDPOSCSBND-L13": "corporate_investment_grade_lt_13_months",
+        "PDPOSCSBND-G13": "corporate_investment_grade_gt_13_months_lt_5_years",
+        "PDPOSCSBND-G5L10": "corporate_investment_grade_gt_5_years_lt_10_years",
+        "PDPOSCSBND-G10": "corporate_investment_grade_gt_10_years",
+        "PDPOSCSBND-BELL13": "corporate_junk_lt_13_months",
+        "PDPOSCSBND-BELG13": "corporate_junk_gt_13_months_lt_5_years",
+        "PDPOSCSBND-BELG5L10": "corporate_junk_gt_5_years_lt_10_years",
+        "PDPOSCSBND-BELG10": "corporate_junk_gt_10_years",
+        "PDPOSABS-ALB": "abs_autos",
+        "PDPOSABS-CCB": "abs_credit_cards",
+        "PDPOSABS-SLB": "abs_student_loans",
+        "PDPOSABS-OAB": "abs_other",
+    },
+}
+
+POSITION_GROUPS_TO_SERIES = {
+    "treasuries": [
+        "PDPOSGS-B",
+        "PDPOSGSC-L2",
+        "PDPOSGSC-G2L3",
+        "PDPOSGSC-G3L6",
+        "PDPOSGSC-G6L7",
+        "PDPOSGSC-G7L11",
+        "PDPOSGSC-G11L21",
+        "PDPOSGSC-G21",
+        "PDPOSFGS-C",
+        "PDPOSTIPS-L2",
+        "PDPOSTIPS-G2",
+        "PDPOSTIPS-G6L11",
+        "PDPOSTIPS-G11",
+        "PDPOSGS-BFRN",
+        "PDPOSFGS-DN",
+    ],
+    "bills": ["PDPOSGS-B"],
+    "coupons": [
+        "PDPOSGSC-L2",
+        "PDPOSGSC-G2L3",
+        "PDPOSGSC-G3L6",
+        "PDPOSGSC-G6L7",
+        "PDPOSGSC-G7L11",
+        "PDPOSGSC-G11L21",
+        "PDPOSGSC-G21",
+    ],
+    "notes": ["PDPOSGS-BFRN", "PDPOSFGS-DN"],
+    "tips": ["PDPOSTIPS-L2", "PDPOSTIPS-G2", "PDPOSTIPS-G6L11", "PDPOSTIPS-G11"],
+    "mbs": [
+        "PDPOSMBSFGS-TBA",
+        "PDPOSMBSFGS-OR",
+        "PDPOSMBSFGS-ST",
+        "PDPOSMBSNA-R",
+        "PDPOSMBSFGS-C",
+        "PDPOSMBSNA-O",
+    ],
+    "cmbs": ["PDPOSMBSFGS-C", "PDPOSMBSNA-O"],
+    "municipal": ["PDPOSSMGO-L13", "PDPOSSMGO-G13", "PDPOSSMGO-G5L10", "PDPOSSMGO-G10"],
+    "corporate": [
+        "PDPOSCSCP",
+        "PDPOSCSBND-L13",
+        "PDPOSCSBND-G13",
+        "PDPOSCSBND-G5L10",
+        "PDPOSCSBND-G10",
+        "PDPOSCSBND-BELL13",
+        "PDPOSCSBND-BELG13",
+        "PDPOSCSBND-BELG5L10",
+        "PDPOSCSBND-BELG10",
+    ],
+    "commercial_paper": ["PDPOSCSCP"],
+    "corporate_ig": [
+        "PDPOSCSBND-L13",
+        "PDPOSCSBND-G13",
+        "PDPOSCSBND-G5L10",
+        "PDPOSCSBND-G10",
+    ],
+    "corporate_junk": [
+        "PDPOSCSBND-BELL13",
+        "PDPOSCSBND-BELG13",
+        "PDPOSCSBND-BELG5L10",
+        "PDPOSCSBND-BELG10",
+    ],
+    "abs": ["PDPOSABS-ALB", "PDPOSABS-CCB", "PDPOSABS-SLB", "PDPOSABS-OAB"],
+}

openbb_platform/providers/federal_reserve/pyproject.toml

@@ -0,0 +1,20 @@
+[tool.poetry]
+name = "openbb-federal-reserve"
+version = "1.4.3"
+description = "US Federal Reserve Data Extension for OpenBB"
+authors = ["OpenBB <hello@openbb.co>"]
+license = "AGPL-3.0-only"
+readme = "README.md"
+packages = [{ include = "openbb_federal_reserve" }]
+
+[tool.poetry.dependencies]
+python = ">=3.9.21,<3.13"
+openbb-core = "^1.4.7"
+beautifulsoup4 = "^4.13.4"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.plugins."openbb_provider_extension"]
+federal_reserve = "openbb_federal_reserve:federal_reserve_provider"

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_central_bank_holdings_fetcher_urllib3_v1.yaml

@@ -0,0 +1,209 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/soma/asofdates/list.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '5002'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 27 May 2024 04:35:48 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - ak_bmsc=5CEBD78D80FAFF663D03C7F967C6BFAE~000000000000000000000000000000~YAAQ0ZUeuLOkqK2PAQAAT0pVuBegPpDjBftM+11du7IGVA3XRL1BwzGFH5f2hUGzz08UJ6iGqzgRnhNTkW61UGe2NCnxaGQuLjbT3RfUlhlyJ6c+5AlTAln7EkxWqArPuN45q5t9sFrQcPPOamu/kmm8EevoYrrLPKe3JPnfMjN3eUY0IGG7zxrPudMxlMHjRxegzJ57hedgBfhrDVYcJYGMaDde6XRV8AoHDkqfbbLl35kUqTWtgKcib8dyRQxH14YuQG/Ay+TFnpwFF8YrJ2vZOI8H64Yz9PoPTQVVWIBK5uQmjdFO5U4gO6UyMtHyBukhJSMoOkXDbRdHfBclPjkPadi2FFG3prnP2SoddDyKOaqTrzom2ff/XUu0e9FDr2ilHFvTBnqhaV8dfsggEb5wUJKVhzzpl9g=;
+        Domain=.newyorkfed.org; Path=/; Expires=Mon, 27 May 2024 06:35:48 GMT; Max-Age=7200
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - Yab7FEkDiYcF61w=
+      x-amzn-requestid:
+      - a5a539bf-df2c-42e7-a2bd-d72e1699a6cc
+      x-amzn-trace-id:
+      - Root=1-66540d13-1201517398dc2f4fc4ec8c51;Parent=3b5499d8af4b6284;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/soma/agency/get/agency%20debts/asof/2019-01-02.json
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWKs7PTVSyUqhWUMrIz0nJzEsvVrJSiAbxE4v901wSS1KVrBSUjAwMLXUNDHUN
+        jJR0FJSSS4szC0DCxobG5q6Ozo6mINHcxJLSosySSlQ9xrpG5iDZzOLi0tQikCY3Dx9fZ5BQcUFR
+        amIKSAjES84vLcjPA/GM9czBBhYkFoUl5pSCHWBmZAAGIJWZeWk5iSWZ+XnO+bkFqXnFYDZII0iy
+        ILUoOTWvxL+0pLgkMQ/kIZhMckZiXnqqW1F+bkBRZn5ReGpqNkjKAKQLTS4yNRHsVLBccWoy2F8h
+        lQVgpzimp+YlVyq4pCaVFCsp1OoQH1amlr6uocYg+zDDyshS18BU1xDscaSw8vN1BKnHFVRmekam
+        IHnkoDKxMAMHFdjxQzms3LzAKQczrIwNQGmR1LAy1zPEDCwzM9NhElgBOBIWKLBIT1jmephhZWQx
+        TMLK3Rt3WBkakpEJzTADy9hiOJRYJo4mjo7gMh9LLjTUNTDGDCxCpbsZltLd2HA4FFkmjibeEYag
+        4hhLYBnpGpiTE1iYKcvI0HiwFlmAKcTW1gIANAgYDFMIAAA=
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '434'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 27 May 2024 04:35:48 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - Yab8DG_2CYcFRVQ=
+      x-amzn-requestid:
+      - 77389215-2812-484c-b360-32319652a4d5
+      x-amzn-trace-id:
+      - Root=1-66540d19-704c63158c84edcacd8d9686;Parent=243faa5217608a67;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_central_bank_holdings_fetcher_urllib3_v2.yaml

@@ -0,0 +1,206 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/soma/asofdates/list.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '5006'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 27 Jun 2024 10:22:35 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - aA3xpHqSiYcFjnQ=
+      x-amzn-requestid:
+      - fcdac34d-710d-4be2-af46-792d9ed26c8e
+      x-amzn-trace-id:
+      - Root=1-667d0670-18c72df81c639990d129e0f5;Parent=27525fc962873525;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/soma/agency/get/agency%20debts/asof/2019-01-02.json
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWKs7PTVSyUqhWUMrIz0nJzEsvVrJSiAbxE4v901wSS1KVrBSUjAwMLXUNDHUN
+        jJR0FJSSS4szC0DCxobG5q6Ozo6mINHcxJLSosySSlQ9xrpG5iDZzOLi0tQikCY3Dx9fZ5BQcUFR
+        amIKSAjES84vLcjPA/GM9czBBhYkFoUl5pSCHWBmZAAGIJWZeWk5iSWZ+XnO+bkFqXnFYDZII0iy
+        ILUoOTWvxL+0pLgkMQ/kIZhMckZiXnqqW1F+bkBRZn5ReGpqNkjKAKQLTS4yNRHsVLBccWoy2F8h
+        lQVgpzimp+YlVyq4pCaVFCsp1OoQH1amlr6uocYg+zDDyshS18BU1xDscaSw8vN1BKnHFVRmekam
+        IHnkoDKxMAMHFdjxQzms3LzAKQczrIwNQGmR1LAy1zPEDCwzM9NhElgBOBIWKLBIT1jmephhZWQx
+        TMLK3Rt3WBkakpEJzTADy9hiOJRYJo4mjo7gMh9LLjTUNTDGDCxCpbsZltLd2HA4FFkmjibeEYag
+        4hhLYBnpGpiTE1iYKcvI0HiwFlmAKcTW1gIANAgYDFMIAAA=
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '434'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 27 Jun 2024 10:22:36 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - aBaI-FAMCYcF_nw=
+      x-amzn-requestid:
+      - 8ffcfa84-16ba-46e5-9d09-42e8da2acd00
+      x-amzn-trace-id:
+      - Root=1-667d3d6c-3442d57f02ec8c1424ab574d;Parent=54f3710835abe975;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_federal_funds_rate_fetcher_urllib3_v1.yaml

@@ -0,0 +1,92 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/unsecured/effr/search.json?startDate=2023-01-01&endDate=2023-06-06
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWUCpKTQtKLEktVrJSiFaoVlBKTUtLTS7JLEt1SSxJVbJSUDIyMDLWNTDTNTBT
+        0lFQKqksAIu6urkFKSnoKBWkFiWn5pWAjFCyUjDVM7BACAZA5DJzUg0hcqbY5IxMIZJm2CTNoZJY
+        TbW0BOs0NlDQUSpJLEpPBTvDrSg/FyxugCoekg8WNQI5oiw/pzQ31TPPKTMnJzM/D+R5QxMTBR2l
+        otSyzOLM/DzPvJTM5MSS/CJQCCgp1OrgDxrT4R00xqC4ITNojIZ30JgYkp9qDAdr0ICyCOUZypjc
+        oDHVNR6sQWOCWqaQW9YYgsozcjKUqa6xwfBONUbmZGYoU12jQVtDUSlDkVsMm+oaDdoaikpBQ35Z
+        Y2QyzDMUBanGeACDxhJbexDW5KNOqjGiIGgGsl1Dj6AhtzVsqmtoOYCpBlSxQvskiO4HdVONsRHZ
+        NZShxfAOGgoqb0Nz2gYNqFmBkTCI6l5Sp6wB91LJa/IZ0rhdM9BBY0RBWUPjds2ABw35NZQhjWso
+        vEEzyGsoGncvyQ4aanUvQQ4gs6yhcfcS5DKyimEqBY0RqANPXtAY0Lhdgzdo8GUoKgWNIfntGgMa
+        t2sGPGjI714aDGQNNchTzUD2vOkRNOS3awyI6Hmb6FkYY+sjgyZbTPQsQAUdRkkLnmwx0bMAZXUM
+        SXBr2ETPAuRsDEloH8oQa2vYRM8cVRw62QKegsE22QI2hsximIh2DSVBA8rqGL6nZ9CAurBkBg0R
+        7ZohHTSgeoCcoDHRNSKihqIkaAY8Q4GKAjKDhoieNyVBM+AZClTUkxk0RPS8KQmaAU81oFKbzKAh
+        ol0zpIMGFDdkBg0R7RpKgmbAMxSoaUFm0NC4hgJF2oBW3qC2E5lBQ0TPm5JUM+BBQ35ZQ8yMwlAO
+        GgPyayhiZhSGctCQPShhokvMjMJQDhoDcseGTXQNaVxDDXhZQ35r2HCY97wpKWto3PMe8FRDfuVt
+        OMzbNeBlveS1awyHebuGgmLYgMY974HOUODhP/JSDTGrzYdw5W1J7iCfiS4xEwpDOGQMDUCplsxE
+        M8ybNQbkN2uG+4SCAbm9S2OiFpsP4QxlQW43wZioteZDOGQsyU8zRkSsBaAkZEAZfQDHsSzJnWgx
+        pvlEy0CHDLkVt7GuEY1bewMdMuTW28a6xCzBH8q5iYKQofFoxBBOM0QNRpiCsitGQQpZIWEKKv4x
+        5KArJLBrhC4DMAWN12LoBK+QMNGzBM2OYOyeM9EzRRUHr5CArpvAtkKC7L6Tsa4RUYMR2H04BILG
+        koLsRNRYxEgMGeIGy4dsyFiA8jo5nUpjXWJW35voDd2QAVUBZIYMUUsAhm7IgEp5MkOGqIGIIRsy
+        5hSEDFENmiEbMmQfB2CsS9w4uSmoZ4bR9CCm1gYNA2BopF+DxsKQzF1zxrrELLw30RuyIWNI9mJY
+        Y11iFt7TLGiwtq2p3AoGJXfyymDiJldolGroEDRknyFhTNRRPjRLNaC6A6Mcom6qMSR3ItdYl7hx
+        cvJTDSg9Y/iefqWwISVBQ1yPG6sPiamgsGqkY9CQPcdtrGtA4x433qChR1kDcgA5xbARkePBeDMU
+        KDdj5BnYOA3IZRiS9Ew15PafjIgcEMYbNKBuLYbvB03QgFImmamGxh2oAU81oFqQzKChcQ9qwIMG
+        1FEhM2iIq6FAyRIj0wyJGoqCVDOQNRTI2RgBTt0mH9nD5UZErhMmf0hiwDMUyAHkZShaj32CXIaR
+        MIipvMHjuVSYZAHVn2QGDY0HPwc6aAzJHa8xInJ1+QBkqEGQagZr5U2toAElWzIzFI3n5kAuG8iy
+        huydLEY0HwAd8KAhv6whcgCU/k0+amUo8lvDRA6ADt2gIb/nTdzq8iFbQ1mCGtzklcJEjn/SP9FQ
+        a1kNaDCJzKAZ3r1LShINUZ1LY1B+xaiBIf1u8OmIGHLQgSzwgZsYktBugjEoQjEkoZ1LM1D7Hks3
+        AXwJAEIcuhYLvEIL61oscgthQyIXl+MLGiNQZsbw4CAJGrL3sRgSubgcX8hQkGiwJkUqJxpQvJFT
+        0hgSOTA8dIOG7EP4DIk6491Ej0ZBQ4eixhCUMslMNUSNSAzhoCG3l2BI5ALzoRs0BqCUSWaqIWpE
+        YsgGjSX5VbcRUQMSQzdkyK+fiDuPZSBCBlR6Itp10OtZTPRIbe8ZkLlWzVCXuPNYBiJojLDdkkV6
+        0JCfn4hbYk5+0ICqB4x2MlG9BJBOilONJfllMHFnjpAfMqCoJy9kQBmB4pAxNAQZQ171RMwp5gPT
+        3qNKojE0AI29khk0A9nrBhW0GEkK1oECRffAppqBrLrpEDRkH+JjSORcwtAta8g+jsWQyGWxNAoa
+        OqQastd+GhJ56MjQDRoKimEDopaqDUTQUGnwEzTWT14NRdxkwkAEDXVqKLyHjgCmEKtQCwAKQ4fm
+        YHcAAA==
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '1828'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 06 Jun 2024 20:57:40 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - ak_bmsc=708282FD0DF0D37D7B8EEC7F6E7FE0D5~000000000000000000000000000000~YAAQ1pUeuGBXpLmPAQAAQ9BX7xhONWLFcCw0okbGYS1e9pk21yRgiUPaNTZNMp5Sv9xCMmLwMKLdnw8O6Hc7zrRz89eYCSlfosascqu+Yqns9+dnqyMafbNYXR1i4J9ECjdQLp8lM2L6xh8gQsdf6ZZVkGVSqC5IDB3Pi1i4wvt78Ceorh+Mf4dGp/TidQtDSRT6Ed4NntmHOWnqzNYlBqwdeijotrIOFBRsrkEbmcsTX+4Ohj+5tKKfXG9+EdvLCrb2eJvB7+U9cthYZec/uWt5lDrA7WEnXvXskwrJFBCOTrHgZnk6pJQtGhkE9oewQLQl0h0gV7izDf/SYN64eCW7wHrSnKgkOj4nXN4Zj0ZdDBdI1o+h6pD9xB1d7PiDHAtWWuMlPcqXReNef/lMse81AoQXJSvvXB4=;
+        Domain=.newyorkfed.org; Path=/; Expires=Thu, 06 Jun 2024 22:57:40 GMT; Max-Age=7200
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - Y9pewFa8CYcFueA=
+      x-amzn-requestid:
+      - 6cc5ccab-5d40-4dfc-a97f-37ab9cdd7ef5
+      x-amzn-trace-id:
+      - Root=1-666222c4-11bb458333c0ee1d7b67d155;Parent=42d70ec18dfba284;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_federal_funds_rate_fetcher_urllib3_v2.yaml

@@ -0,0 +1,89 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/unsecured/effr/search.json?startDate=2023-01-01&endDate=2023-06-06
+  response:
+    body:
+      string: !!binary |
+        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
+        YHcAAA==
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '1828'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 27 Jun 2024 10:22:35 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - aBaIwHoWiYcFhkQ=
+      x-amzn-requestid:
+      - e7fb1759-2758-4603-93d2-6fd7dc6cb84e
+      x-amzn-trace-id:
+      - Root=1-667d3d6a-20954503ee4954595abe5cae;Parent=0c6de0f786049405;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_fomc_documents_fetcher_urllib3_v1.yaml

@@ -0,0 +1,311 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      CF-Cache-Status:
+      - HIT
+      CF-RAY:
+      - 920506b69bf398dc-YVR
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - text/html
+      Date:
+      - Fri, 14 Mar 2025 16:07:49 GMT
+      Last-Modified:
+      - Wed, 19 Feb 2025 19:00:45 GMT
+      Server:
+      - cloudflare
+      Set-Cookie:
+      - __cf_bm=gBemx_ArIsqRSTFARnkuhxG7wDowyML2lcNBQNJuPlI-1741968469-1.0.1.1-NlCP8uodX1p.KyojVGUL46iC6.0yS4G0dS0xEbb9L7rIszAgpYPHQLWIwqmBb0oYOuK5oSZdr79ZEaU1U8ttLLE6DCvtuFG_Pr3gwx2IXWU;
+        path=/; expires=Fri, 14-Mar-25 16:37:49 GMT; domain=.federalreserve.gov; HttpOnly;
+        Secure; SameSite=None
+      - _cfuvid=Zb.eHsA.OmFG7nd3ikj09NAVXFd79rgr8b3pSK0Q87I-1741968469629-0.0.1.1-604800000;
+        path=/; domain=.federalreserve.gov; HttpOnly; Secure; SameSite=None
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains; preload
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding
+      X-Frame-Options:
+      - SAMEORIGIN
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_overnight_bank_funding_rate_fetcher_urllib3_v1.yaml

@@ -0,0 +1,63 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/unsecured/obfr/search.json?startDate=2024-06-01&endDate=2024-06-06
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWUCpKTQtKLEktVrJSiFaoVlBKTUtLTS7JLEt1SSxJVbJSUDIyMDLRNTDTNTBT
+        0lFQKqksAIv6O7kFKSnoKBWkFiWn5pWAjFCyUjDVMzZCCAZA5DJzUg3Bckam2OSMTMGSxobYJM2h
+        ksbYJC0tITotFXSUyvJzSnNTPfOcMnNyMvPzQN4xsgDZV5RallmcmZ/nmZeSmZxYkl8E8pOSQq0O
+        fs+aDlbPWuDwrDlIgkzPmgw1z1oYKOgokelZ46HmWXN8yRgwhViFWgD5Rz99xgMAAA==
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '220'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Tue, 11 Jun 2024 02:34:03 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - cookiesession1=678A3E0EE607407E823ED4EA4F0C28B9;Expires=Wed, 11 Jun 2025 02:34:03
+        GMT;Path=/;Secure;HttpOnly
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - ZLmgUG4BCYcFe8Q=
+      x-amzn-requestid:
+      - b77d47db-cd3e-492d-a63f-1ab9a17c16f8
+      x-amzn-trace-id:
+      - Root=1-6667b79b-358f5ab1a50c2313c1e18089;Parent=15119c60494acd17;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_overnight_bank_funding_rate_fetcher_urllib3_v2.yaml

@@ -0,0 +1,60 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/unsecured/obfr/search.json?startDate=2024-06-01&endDate=2024-06-06
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWUCpKTQtKLEktVrJSiFaoVlBKTUtLTS7JLEt1SSxJVbJSUDIyMDLRNTDTNTBT
+        0lFQKqksAIv6O7kFKSnoKBWkFiWn5pWAjFCyUjDVMzZCCAZA5DJzUg3Bckam2OSMTMGSxobYJM2h
+        ksbYJC0tITotFXSUyvJzSnNTPfOcMnNyMvPzQN4xsgDZV5RallmcmZ/nmZeSmZxYkl8E8pOSQq0O
+        fs+aDlbPWuDwrDlIgkzPmgw1z1oYKOgokelZ46HmWXN8yRgwhViFWgD5Rz99xgMAAA==
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '220'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 27 Jun 2024 10:22:37 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - aBaJFF_RiYcFrCQ=
+      x-amzn-requestid:
+      - 1ca86d24-755a-4112-a2d6-7755eacd57ec
+      x-amzn-trace-id:
+      - Root=1-667d3d6d-bbbfce79698eea6b630f7dbe;Parent=316f2a5810eaac9b;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_primary_dealer_positioning_fetcher_urllib3_v1.yaml

@@ -0,0 +1,332 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/pd/get/PDPOSMBSFGS-C.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '6198'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 08 Jul 2024 18:11:23 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - ak_bmsc=0B65662A9954DFA743EEB73F011D118F~000000000000000000000000000000~YAAQ0ZUeuCg54JCQAQAAshKLkxhGjDMoJmwYISW851j4waSXYIebQT++w978bp5zg4H1iFu2jap0KCWK3+ammrivZxnn33J/BO/dQwS3Nuri6ljgAmXhNJcW2znKo8smy443fHh7Dq16wkHiSo0Q42QwDXT7XbSwe7VwLfFcP7Vtl4j3CkKyQc4yinimxskfGORGGWWcux/FVqXOIjRRophoBs2bN+mCITM+WaUb8ARtYaqG80aFhUxwgY1UN/jPyUnTZAFFeht272UuHx4VP9Zo/zEQf/KYt9Rjvg6aGC5lI3qBUhZQ1um0WfeKS3krQCFRylz6wF9mtE0AUHaGyf9IJol4ShRSO3Z2WfvjSqk357t1TCNr+WKcNHrQ6FEhCxrNU9uEV4MRgEUDhqGR+jbUNTrfQYwg4XI=;
+        Domain=.newyorkfed.org; Path=/; Expires=Mon, 08 Jul 2024 20:11:23 GMT; Max-Age=7200
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - amkp9FBDCYcFt5g=
+      x-amzn-requestid:
+      - 4a2dbdb4-e23d-4e94-bbcf-916957a7902b
+      x-amzn-trace-id:
+      - Root=1-668c1b0c-de48952568b0d573f4edc0ce;Parent=294993a21cb67610;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/pd/get/PDPOSMBSNA-O.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '6073'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 08 Jul 2024 18:11:23 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - ak_bmsc=D00965083550F1E90FB1207197FEBD4B~000000000000000000000000000000~YAAQ0ZUeuCo54JCQAQAAwBKLkxilxtmYV+I3KvT4zBHiAvl38pmDVoszKQEum3Faxkf9XXxtv69xS3HKUypFYAgGYZMXD8Ob6Lob0wXZ/YFVgePdwc38PSKHAnfHrYf02RO1s8pRgBAvN9kjIT+PdKc2HJInS0/UMXqCJ2JX3fLlSN7NePJBFRWrQKfGWV0xyQMJx/ox640WUja5kSUsgsMjYEhjTolmRoKOVOk2bYFEwG3lGYCQM1fcrKNFMtTZ2Wpyw811hvt/6nVAEOSCl5JHGLCSwwbtxlE6oMehD0gTgsZJNs13VoSt6/md4NvqPFadYccsxdR5NWEt26wMPpGIg02Sjr+Q6OIW4HcRDDZv+PdA0axglt0tU8ZhPsvAz4+R/JJVOaNK4RjWrUHffV3QuAwrHB7Yc4U=;
+        Domain=.newyorkfed.org; Path=/; Expires=Mon, 08 Jul 2024 20:11:23 GMT; Max-Age=7200
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - amkp-FS6CYcFaEg=
+      x-amzn-requestid:
+      - c6d1cded-25f6-4f12-a453-97f1d0c6586f
+      x-amzn-trace-id:
+      - Root=1-668c1b0c-a8849b395e07d52704e58320;Parent=668155561a1cf466;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_primary_dealer_positioning_fetcher_urllib3_v2.yaml

@@ -0,0 +1,326 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/pd/get/PDPOSMBSNA-O.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '6073'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 08 Jul 2024 18:03:04 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - amkp-FS6CYcFaEg=
+      x-amzn-requestid:
+      - c6d1cded-25f6-4f12-a453-97f1d0c6586f
+      x-amzn-trace-id:
+      - Root=1-668c1b0c-a8849b395e07d52704e58320;Parent=668155561a1cf466;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/pd/get/PDPOSMBSFGS-C.json
+  response:
+    body:
+      string: !!binary |
+        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
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '6198'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Mon, 08 Jul 2024 18:03:04 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - amkp9FBDCYcFt5g=
+      x-amzn-requestid:
+      - 4a2dbdb4-e23d-4e94-bbcf-916957a7902b
+      x-amzn-trace-id:
+      - Root=1-668c1b0c-de48952568b0d573f4edc0ce;Parent=294993a21cb67610;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_sofr_fetcher_urllib3_v1.yaml

@@ -0,0 +1,64 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/secured/sofr/search.json?startDate=2024-06-01&endDate=2024-06-06
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWUCpKTQtKLEktVrJSiFaoVlBKTUtLTS7JLEt1SSxJVbJSUDIyMDLRNTDTNTBT
+        0lFQKqksAIsG+7sFKSnoKBWkFiWn5pWAjFCyUjDVMzZGCAZA5DJzUg3BckaW2OSMTMGSxkbYJM0h
+        kiYG2CQtLcE6TUwUdJTK8nNKc1M985wyc3Iy8/NA3jEyMLBQ0FEqSi3LLM7Mz/PMS8lMTizJLwJ5
+        SkmhVge/b00p9a0xVjcT41tjrOEE8y0ogLH41tDSAqSNTN+aUOpbusetJSi9kOlbY6J8a4otzQ1I
+        Sja0NMTnW8AUYhVqAQ8xhrzKAwAA
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '249'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 08 Jun 2024 05:59:35 GMT
+      Pragma:
+      - no-cache
+      Set-Cookie:
+      - cookiesession1=678A3E0EBA19E6E38D9D5186C73F260F;Expires=Sun, 08 Jun 2025 05:59:35
+        GMT;Path=/;Secure;HttpOnly
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - ZCLzNFtZiYcFmHQ=
+      x-amzn-requestid:
+      - 67713ca6-2c16-438f-a2a5-fd48b4fb02a1
+      x-amzn-trace-id:
+      - Root=1-6663f347-775ee28c7594e08357ca5722;Parent=7fe874cce0755572;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/record/http/test_federal_reserve_fetchers/test_federal_reserve_sofr_fetcher_urllib3_v2.yaml

@@ -0,0 +1,61 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Connection:
+      - keep-alive
+    method: GET
+    uri: https://markets.newyorkfed.org/api/rates/secured/sofr/search.json?startDate=2024-06-01&endDate=2024-06-06
+  response:
+    body:
+      string: !!binary |
+        H4sIAAAAAAAEA6pWUCpKTQtKLEktVrJSiFaoVlBKTUtLTS7JLEt1SSxJVbJSUDIyMDLRNTDTNTBT
+        0lFQKqksAIsG+7sFKSnoKBWkFiWn5pWAjFCyUjDVMzZGCAZA5DJzUg3BckaW2OSMTMGSxkbYJM0h
+        kiYG2CQtLcE6TUwUdJTK8nNKc1M985wyc3Iy8/NA3jEyMLBQ0FEqSi3LLM7Mz/PMS8lMTizJLwJ5
+        SkmhVge/b00p9a0xVjcT41tjrOEE8y0ogLH41tDSAqSNTN+aUOpbusetJSi9kOlbY6J8a4otzQ1I
+        Sja0NMTnW8AUYhVqAQ8xhrzKAwAA
+    headers:
+      Access-Control-Allow-Headers:
+      - Content-Type,Content-Disposition
+      Access-Control-Allow-Methods:
+      - OPTIONS,GET
+      Access-Control-Allow-Origin:
+      - '*'
+      Access-Control-Expose-Headers:
+      - Content-Disposition
+      Cache-Control:
+      - no-store
+      Connection:
+      - keep-alive
+      Content-Encoding:
+      - gzip
+      Content-Length:
+      - '249'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Thu, 27 Jun 2024 10:22:36 GMT
+      Pragma:
+      - no-cache
+      Vary:
+      - Accept-Encoding
+      strict-transport-security:
+      - max-age=31536000; includeSubDomains
+      x-amz-apigw-id:
+      - aBaJCEsPiYcFdlQ=
+      x-amzn-requestid:
+      - 79bfb88b-47c7-4921-a8c4-f1bb33fd1e41
+      x-amzn-trace-id:
+      - Root=1-667d3d6c-1dc4236a875e19392ac99ad5;Parent=7e8d1f0f7d2a5a62;Sampled=0;lineage=e7c0e2ee:0
+      x-frame-options:
+      - SAMEORIGIN
+      x-xss-protection:
+      - 1; mode=block
+    status:
+      code: 200
+      message: OK
+version: 1

openbb_platform/providers/federal_reserve/tests/test_federal_reserve_fetchers.py

@@ -0,0 +1,157 @@
+"""Tests for the Federal Reserve fetchers."""
+
+from datetime import date
+
+import pytest
+from openbb_core.app.service.user_service import UserService
+from openbb_federal_reserve.models.central_bank_holdings import (
+    FederalReserveCentralBankHoldingsFetcher,
+)
+from openbb_federal_reserve.models.federal_funds_rate import (
+    FederalReserveFederalFundsRateFetcher,
+)
+from openbb_federal_reserve.models.fomc_documents import (
+    FederalReserveFomcDocumentsFetcher,
+)
+from openbb_federal_reserve.models.money_measures import (
+    FederalReserveMoneyMeasuresFetcher,
+)
+from openbb_federal_reserve.models.overnight_bank_funding_rate import (
+    FederalReserveOvernightBankFundingRateFetcher,
+)
+from openbb_federal_reserve.models.primary_dealer_fails import (
+    FederalReservePrimaryDealerFailsFetcher,
+)
+from openbb_federal_reserve.models.primary_dealer_positioning import (
+    FederalReservePrimaryDealerPositioningFetcher,
+)
+from openbb_federal_reserve.models.sofr import FederalReserveSOFRFetcher
+from openbb_federal_reserve.models.treasury_rates import (
+    FederalReserveTreasuryRatesFetcher,
+)
+from openbb_federal_reserve.models.yield_curve import FederalReserveYieldCurveFetcher
+
+test_credentials = UserService().default_user_settings.credentials.model_dump(
+    mode="json"
+)
+
+
+@pytest.fixture(scope="module")
+def vcr_config():
+    """VCR config."""
+    return {
+        "filter_headers": [("User-Agent", None)],
+        "filter_query_parameters": [],
+    }
+
+
+@pytest.mark.record_http
+def test_federal_reserve_treasury_rates_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve Treasury Rates fetcher."""
+    params = {"start_date": date(2023, 1, 1), "end_date": date(2023, 5, 10)}
+
+    fetcher = FederalReserveTreasuryRatesFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_money_measures_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve Money Measures fetcher."""
+    params = {"start_date": date(2023, 1, 1), "end_date": date(2023, 5, 10)}
+
+    fetcher = FederalReserveMoneyMeasuresFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_federal_funds_rate_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve Federal Funds Rate fetcher."""
+    params = {"start_date": date(2023, 1, 1), "end_date": date(2023, 6, 6)}
+
+    fetcher = FederalReserveFederalFundsRateFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_yield_curve_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve yield curve fetcher."""
+    params = {"date": "2024-05-13,2020-05-09"}
+
+    fetcher = FederalReserveYieldCurveFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_central_bank_holdings_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve Central Bank Holdings Fetcher."""
+    params = {"date": date(2019, 1, 2), "holding_type": "agency_debts"}
+
+    fetcher = FederalReserveCentralBankHoldingsFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_sofr_fetcher(credentials=test_credentials):
+    """Test the Federal Reserve SOFR Fetcher."""
+    params = {"start_date": date(2024, 6, 1), "end_date": date(2024, 6, 6)}
+
+    fetcher = FederalReserveSOFRFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_overnight_bank_funding_rate_fetcher(
+    credentials=test_credentials,
+):
+    """Test the Federal Reserve Overnight Bank Funding Rate Fetcher."""
+    params = {"start_date": date(2024, 6, 1), "end_date": date(2024, 6, 6)}
+
+    fetcher = FederalReserveOvernightBankFundingRateFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_primary_dealer_positioning_fetcher(
+    credentials=test_credentials,
+):
+    """Test the Federal Reserve Primary Dealer Positioning Fetcher."""
+    params = {
+        "category": "cmbs",
+        "start_date": date(2024, 6, 1),
+        "end_date": date(2024, 6, 30),
+    }
+
+    fetcher = FederalReservePrimaryDealerPositioningFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_primary_dealer_fails_fetcher(
+    credentials=test_credentials,
+):
+    """Test the Federal Reserve Primary Dealer Fails Fetcher."""
+    params = {}
+
+    fetcher = FederalReservePrimaryDealerFailsFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None
+
+
+@pytest.mark.record_http
+def test_federal_reserve_fomc_documents_fetcher(
+    credentials=test_credentials,
+):
+    """Test the Federal Reserve FOMC Documents Fetcher."""
+    params = {}
+
+    fetcher = FederalReserveFomcDocumentsFetcher()
+    result = fetcher.test(params, credentials)
+    assert result is None

openbb_platform/providers/finra/README.md

@@ -0,0 +1,13 @@
+# OpenBB FINRA Provider
+
+This extension integrates the [FINRA](https://finra.org/) data provider into the OpenBB Platform.
+
+## Installation
+
+To install the extension:
+
+```bash
+pip install openbb-finra
+```
+
+Documentation available [here](https://docs.openbb.co/platform/developer_guide/contributing).

openbb_platform/providers/finra/__init__.py

@@ -0,0 +1 @@
+"""FINRA provider for OpenBB Platform."""

openbb_platform/providers/finra/openbb_finra/__init__.py

@@ -0,0 +1,18 @@
+"""FINRA provider module."""
+
+from openbb_core.provider.abstract.provider import Provider
+from openbb_finra.models.equity_short_interest import FinraShortInterestFetcher
+from openbb_finra.models.otc_aggregate import FinraOTCAggregateFetcher
+
+finra_provider = Provider(
+    name="finra",
+    website="https://www.finra.org/finra-data",
+    description="""FINRA Data provides centralized access to the abundance of data FINRA
+makes available to the public, media, researchers and member firms.""",
+    credentials=None,
+    fetcher_dict={
+        "OTCAggregate": FinraOTCAggregateFetcher,
+        "EquityShortInterest": FinraShortInterestFetcher,
+    },
+    repr_name="Financial Industry Regulatory Authority (FINRA)",
+)

openbb_platform/providers/finra/openbb_finra/models/equity_short_interest.py

@@ -0,0 +1,88 @@
+"""FINRA Equity Short Interest Model."""
+
+# pylint: disable=unused-argument
+
+from typing import Any, Dict, List, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.equity_short_interest import (
+    ShortInterestData,
+    ShortInterestQueryParams,
+)
+
+
+class FinraShortInterestQueryParams(ShortInterestQueryParams):
+    """FINRA Equity Short Interest Query."""
+
+
+class FinraShortInterestData(ShortInterestData):
+    """FINRA Equity Short Interest Data."""
+
+    __alias_dict__ = {
+        "symbol": "symbolCode",
+        "issue_name": "issueName",
+        "market_class": "marketClassCode",
+        "current_short_position": "currentShortPositionQuantity",
+        "previous_short_position": "previousShortPositionQuantity",
+        "avg_daily_volume": "averageDailyVolumeQuantity",
+        "days_to_cover": "daysToCoverQuantity",
+        "change": "changePreviousNumber",
+        "change_pct": "changePercent",
+        "settlement_date": "settlementDate",
+    }
+
+
+class FinraShortInterestFetcher(
+    Fetcher[FinraShortInterestQueryParams, List[FinraShortInterestData]]
+):
+    """Transform the query, extract and transform the data from the FINRA endpoints."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> FinraShortInterestQueryParams:
+        """Transform query params."""
+        return FinraShortInterestQueryParams(**params)
+
+    @staticmethod
+    def extract_data(
+        query: FinraShortInterestQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the data from the Finra endpoint."""
+        # pylint: disable=import-outside-toplevel
+        import sqlite3  # noqa
+        from openbb_finra.utils.data_storage import get_db_path, prepare_data  # noqa
+
+        DB_PATH = get_db_path()
+        # Put the data in the cache
+        prepare_data()
+        # Get the data from the cache
+        cnx = sqlite3.connect(DB_PATH)
+        cursor = cnx.cursor()
+        cursor.execute(
+            "SELECT * FROM short_interest where symbolCode = ?", (query.symbol,)
+        )
+        # TODO: Check if we should allow general queries, it's more than 500k rows
+        # cursor.execute("SELECT * FROM short_interest")
+        result = cursor.fetchall()
+
+        titles = [
+            "symbolCode",
+            "issueName",
+            "marketClassCode",
+            "currentShortPositionQuantity",
+            "previousShortPositionQuantity",
+            "averageDailyVolumeQuantity",
+            "daysToCoverQuantity",
+            "changePercent",
+            "changePreviousNumber",
+            "settlementDate",
+        ]
+        return [dict(zip(titles, list(row)[1:])) for row in result]
+
+    @staticmethod
+    def transform_data(
+        query: FinraShortInterestQueryParams, data: List[Dict], **kwargs: Any
+    ) -> List[FinraShortInterestData]:
+        """Transform the data."""
+        return [FinraShortInterestData.model_validate(d) for d in data]

openbb_platform/providers/finra/openbb_finra/models/otc_aggregate.py

@@ -0,0 +1,64 @@
+"""FINRA OTC Aggregate Model."""
+
+from typing import Any, Dict, List, Literal, Optional
+
+from openbb_core.provider.abstract.fetcher import Fetcher
+from openbb_core.provider.standard_models.otc_aggregate import (
+    OTCAggregateData,
+    OTCAggregateQueryParams,
+)
+from pydantic import Field
+
+
+class FinraOTCAggregateQueryParams(OTCAggregateQueryParams):
+    """FINRA OTC Aggregate Query."""
+
+    tier: Literal["T1", "T2", "OTCE"] = Field(
+        default="T1",
+        description=""""T1 - Securities included in the S&P 500, Russell 1000 and selected exchange-traded products;
+        T2 - All other NMS stocks; OTC - Over-the-Counter equity securities""",
+    )
+    is_ats: bool = Field(
+        default=True, description="ATS data if true, NON-ATS otherwise"
+    )
+
+
+class FinraOTCAggregateData(OTCAggregateData):
+    """FINRA OTC Aggregate Data."""
+
+    __alias_dict__ = {
+        "share_quantity": "totalWeeklyShareQuantity",
+        "trade_quantity": "totalWeeklyTradeCount",
+        "update_date": "lastUpdateDate",
+    }
+
+
+class FinraOTCAggregateFetcher(
+    Fetcher[FinraOTCAggregateQueryParams, List[FinraOTCAggregateData]]
+):
+    """Transform the query, extract and transform the data from the FINRA endpoints."""
+
+    @staticmethod
+    def transform_query(params: Dict[str, Any]) -> FinraOTCAggregateQueryParams:
+        """Transform query params."""
+        return FinraOTCAggregateQueryParams(**params)
+
+    # pylint: disable=unused-argument
+    @staticmethod
+    def extract_data(
+        query: FinraOTCAggregateQueryParams,
+        credentials: Optional[Dict[str, str]],
+        **kwargs: Any,
+    ) -> List[Dict]:
+        """Extract the data from the FINRA endpoint."""
+        # pylint: disable=import-outside-toplevel
+        from openbb_finra.utils.helpers import get_full_data
+
+        return get_full_data(query.symbol, query.tier, query.is_ats)
+
+    @staticmethod
+    def transform_data(
+        query: FinraOTCAggregateQueryParams, data: List[Dict], **kwargs: Any
+    ) -> List[FinraOTCAggregateData]:
+        """Transform the data."""
+        return [FinraOTCAggregateData.model_validate(d) for d in data if d]

openbb_platform/providers/finra/openbb_finra/utils/data_storage.py

@@ -0,0 +1,84 @@
+"""Utility for FINRA data storage.
+
+This was created as a way to handle short interest data from the FINRA.
+The files do not change, so there is no need to download them every time.
+"""
+
+from typing import List
+
+from openbb_core.app.utils import get_user_cache_directory
+from openbb_finra.utils.helpers import get_short_interest_dates
+
+
+def get_db_path():
+    """Return the path to the database."""
+    # pylint: disable=import-outside-toplevel
+    from pathlib import Path
+
+    DB_PATH = Path(get_user_cache_directory()) / "caches/finra_short_volume.db"
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+    return DB_PATH
+
+
+def get_cached_dates() -> List:
+    """Return the dates that are cached in the DB file."""
+    # pylint: disable=import-outside-toplevel
+    import sqlite3  # noqa
+
+    DB_PATH = get_db_path()
+    cnx = sqlite3.connect(DB_PATH)
+    cursor = cnx.cursor()
+
+    # Check if the table exists
+    cursor.execute(
+        "SELECT * FROM sqlite_master WHERE type='table' AND name='short_interest'"
+    )
+    if cursor.fetchone() is None:
+        # The table does not exist
+        return []
+
+    # If the table exists, fetch the data
+    cursor.execute("SELECT distinct settlementDate FROM short_interest")
+    result = cursor.fetchall()
+    return [row[0] for row in result]
+
+
+def get_data_from_date_and_store(date):
+    """Get data from a specific date and place it in the cache."""
+    # pylint: disable=import-outside-toplevel
+    import random  # noqa
+    import sqlite3  # noqa
+    from io import StringIO  # noqa
+    from openbb_core.provider.utils.helpers import make_request  # noqa
+    from pandas import read_csv  # noqa
+
+    DB_PATH = get_db_path()
+    url = f"https://cdn.finra.org/equity/otcmarket/biweekly/shrt{date}.csv"
+    # add a random string to user agent to avoid getting blocked
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+        + str(random.randint(0, 9))  # noqa: S311
+    }
+    req = make_request(url, headers=headers, timeout=1)
+    if req.status_code != 200:
+        return
+    data = read_csv(StringIO(req.text), delimiter="|")
+    data = data.drop(
+        columns=[
+            "accountingYearMonthNumber",
+            "issuerServicesGroupExchangeCode",
+            "stockSplitFlag",
+            "revisionFlag",
+        ]
+    )
+    data.to_sql("short_interest", sqlite3.connect(DB_PATH), if_exists="append")
+
+
+def prepare_data():
+    """Prepare the data."""
+    date_list = get_short_interest_dates()
+    cached_urls = get_cached_dates()
+    for date in date_list:
+        if f"{date[:4]}-{date[4:6]}-{date[6:]}" not in cached_urls:
+            get_data_from_date_and_store(date)

openbb_platform/providers/finra/openbb_finra/utils/helpers.py

@@ -0,0 +1,186 @@
+"""Helper functions for FINRA API."""
+
+import datetime
+from typing import List
+
+# pylint: disable=W0621
+
+
+def get_finra_weeks(tier: str = "T1", is_ats: bool = True):
+    """Fetch the available weeks from FINRA that can be used."""
+    # pylint: disable=import-outside-toplevel
+    from openbb_core.provider.utils.helpers import make_request
+
+    request_header = {"Accept": "application/json", "Content-Type": "application/json"}
+
+    request_data = {
+        "compareFilters": [
+            {
+                "compareType": "EQUAL",
+                "fieldName": "summaryTypeCode",
+                "fieldValue": "ATS_W_SMBL" if is_ats else "OTC_W_SMBL",
+            },
+            {
+                "compareType": "EQUAL",
+                "fieldName": "tierIdentifier",
+                "fieldValue": tier,
+            },
+        ],
+        "delimiter": "|",
+        "fields": ["weekStartDate"],
+        "limit": 52,
+        "quoteValues": False,
+        "sortFields": ["-weekStartDate"],
+    }
+
+    response = make_request(
+        method="POST",
+        url="https://api.finra.org/data/group/otcMarket/name/weeklyDownloadDetails",
+        headers=request_header,
+        json=request_data,
+        timeout=3,
+    )
+
+    return response.json() if response.status_code == 200 else []
+
+
+def get_finra_data(symbol, week_start, tier: str = "T1", is_ats: bool = True):
+    """Get the data for a symbol from FINRA."""
+    # pylint: disable=import-outside-toplevel
+    from openbb_core.provider.utils.helpers import make_request
+
+    req_hdr = {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ",
+    }
+
+    filters = [
+        {
+            "compareType": "EQUAL",
+            "fieldName": "weekStartDate",
+            "fieldValue": week_start,
+        },
+        {"compareType": "EQUAL", "fieldName": "tierIdentifier", "fieldValue": tier},
+        {
+            "compareType": "EQUAL",
+            "description": "",
+            "fieldName": "summaryTypeCode",
+            "fieldValue": "ATS_W_SMBL" if is_ats else "OTC_W_SMBL",
+        },
+    ]
+
+    if symbol:
+        filters.append(
+            {
+                "compareType": "EQUAL",
+                "fieldName": "issueSymbolIdentifier",
+                "fieldValue": symbol,
+            }
+        )
+
+    req_data = {
+        "compareFilters": filters,
+        "delimiter": "|",
+        "fields": [
+            "issueSymbolIdentifier",
+            "totalWeeklyShareQuantity",
+            "totalWeeklyTradeCount",
+            "lastUpdateDate",
+        ],
+        "limit": 5000,
+        "quoteValues": False,
+        "sortFields": ["totalWeeklyShareQuantity"],
+    }
+    response = make_request(
+        url="https://api.finra.org/data/group/otcMarket/name/weeklySummary",
+        method="POST",
+        headers=req_hdr,
+        json=req_data,
+        timeout=20,
+    )
+    return response
+
+
+def get_full_data(symbol, tier: str = "T1", is_ats: bool = True):
+    """Get the full data for a symbol from FINRA."""
+    weeks = [week["weekStartDate"] for week in get_finra_weeks(tier, is_ats)]
+
+    data = []
+    for week in weeks:
+        response = get_finra_data(symbol, week, tier, is_ats)
+        r_json = response.json()
+        if response.status_code == 200 and r_json:
+            data.append(response.json()[0])
+
+    return data
+
+
+def get_adjusted_date(year, month, day):
+    """Find the closest date if the date falls on a weekend."""
+    # Get the date
+    date = datetime.date(year, month, day)
+
+    # If the date is a Saturday, subtract one day
+    if date.weekday() == 5:
+        date -= datetime.timedelta(days=1)
+    # If the date is a Sunday, subtract two days
+    elif date.weekday() == 6:
+        date -= datetime.timedelta(days=2)
+
+    return date
+
+
+def get_short_interest_dates() -> List[str]:
+    """Get a list of dates for which the short interest data is available.
+
+    It is reported on the 15th and the last day of each month,but if the date falls on a weekend,
+    the date is adjusted to the closest friday.
+    """
+
+    def get_adjusted_date(year, month, day):
+        """Find the closest date if the date falls on a weekend."""
+        # Get the date
+        date = datetime.date(year, month, day)
+
+        # If the date is a Saturday, subtract one day
+        if date.weekday() == 5:
+            date -= datetime.timedelta(days=1)
+        # If the date is a Sunday, subtract two days
+        elif date.weekday() == 6:
+            date -= datetime.timedelta(days=2)
+
+        return date
+
+    start_year = 2021
+    today = datetime.date.today()  # Get today's date
+    end_year = today.year
+    dates_list = []
+
+    for yr in range(start_year, end_year + 1):
+        start_month = 7 if yr == start_year else 1
+        end_month = 12 if yr < today.year else today.month - 1
+        for month in range(start_month, end_month + 1):  # Start from July for 2021
+            # Date for the 15th of the month
+            date_15 = get_adjusted_date(yr, month, 15)
+            dates_list.append(date_15.strftime("%Y%m%d"))
+
+            # Date for the last day of the month
+            if month == 2:  # February
+                last_day = (
+                    29 if (yr % 4 == 0 and yr % 100 != 0) or (yr % 400 == 0) else 28
+                )
+            elif month in [4, 6, 9, 11]:  # Months with 30 days
+                last_day = 30
+            else:  # Months with 31 days
+                last_day = 31
+
+            last_date = get_adjusted_date(yr, month, last_day)
+            dates_list.append(last_date.strftime("%Y%m%d"))
+
+    # Manually replace '20220415' with '20220414' due to holiday
+    if "20220415" in dates_list:
+        index = dates_list.index("20220415")
+        dates_list[index] = "20220414"
+
+    return dates_list