MOD: Improve corporate actions API

cjdsellers · cjdsellers · commit 0960ec193552 · 2024-08-12T21:40:38.000Z
diff --git a/databento/common/parsing.py b/databento/common/parsing.py
@@ -58,6 +58,26 @@ def optional_values_list_to_string(
     return values_list_to_string(values)
 
 
+def optional_string_to_list(
+    value: Iterable[str] | str | None,
+) -> Iterable[str] | list[str] | None:
+    """
+    Convert a comma-separated string into a list of strings, or return the
+    original input if not a string.
+
+    Parameters
+    ----------
+    value : iterable of str or str, optional
+        The input value to be parsed.
+
+    Returns
+    -------
+    Iterable[str] | list[str] | `None`
+
+    """
+    return value.strip().strip(",").split(",") if isinstance(value, str) else value
+
+
 def optional_symbols_list_to_list(
     symbols: Iterable[str | int | Integral] | str | int | Integral | None,
     stype_in: SType,
diff --git a/databento/reference/api/corporate.py b/databento/reference/api/corporate.py
@@ -15,6 +15,7 @@
 from databento.common.parsing import convert_datetime_columns
 from databento.common.parsing import datetime_to_string
 from databento.common.parsing import optional_datetime_to_string
+from databento.common.parsing import optional_string_to_list
 from databento.common.parsing import optional_symbols_list_to_list
 
 
@@ -31,10 +32,14 @@ def get_range(
         self,
         start: pd.Timestamp | date | str | int,
         end: pd.Timestamp | date | str | int | None = None,
+        index: str = "event_date",
         symbols: Iterable[str] | str | None = None,
         stype_in: SType | str = "raw_symbol",
         events: Iterable[str] | str | None = None,
-        us_only: bool = False,
+        countries: Iterable[str] | str | None = None,
+        security_types: Iterable[str] | str | None = None,
+        flatten: bool = True,
+        pit: bool = False,
     ) -> pd.DataFrame:
         """
         Request a new corporate actions time series from Databento.
@@ -51,8 +56,9 @@ def get_range(
             The end datetime of the request time range (exclusive).
             Assumes UTC as timezone unless passed a tz-aware object.
             If an integer is passed, then this represents nanoseconds since the UNIX epoch.
-            Values are forward filled based on the resolution provided.
-            Defaults to the same value as `start`.
+        index : str, default 'event_date'
+            The index column to filter the `start` and `end` time range on.
+            Use any of 'event_date', 'ex_date' or 'ts_record'.
         symbols : Iterable[str] or str, optional
             The symbols to filter for. Takes up to 2,000 symbols per request.
             If more than 1 symbol is specified, the data is merged and sorted by time.
@@ -64,10 +70,27 @@ def get_range(
         events : Iterable[str] or str, optional
             The event types to filter for.
             Takes any number of event types per request.
-            If not specified then will be for **all** event types.
+            If not specified then will select **all** event types by default.
             See [EVENT](https://databento.com/docs/standards-and-conventions/reference-data-enums#event) enum.
-        us_only : bool, default False
-            If filtering for US markets only.
+        countries : Iterable[str] or str, optional
+            The listing countries to filter for.
+            Takes any number of two letter ISO 3166-1 alpha-2 country codes per request.
+            If not specified then will select **all** listing countries by default.
+            See [CNTRY](https://databento.com/docs/standards-and-conventions/reference-data-enums#cntry) enum.
+        security_types : Iterable[str] or str, optional
+            The security types to filter for.
+            Takes any number of security types per request.
+            If not specified then will select **all** security types by default.
+            See [SECTYPE](https://databento.com/docs/standards-and-conventions/reference-data-enums#sectype) enum.
+        flatten : bool, default True
+            If nested JSON objects within the `date_info`, `rate_info`, and `event_info` fields
+            should be flattened into separate columns in the resulting DataFrame.
+        pit : bool, default False
+            Determines whether to retain all historical records or only the latest records.
+            If True, all historical records for each `event_unique_id` will be retained, preserving
+            the complete point-in-time history.
+            If False (default), the DataFrame will include only the most recent record for each
+            `event_unique_id` based on the `ts_record` timestamp.
 
         Returns
         -------
@@ -76,17 +99,19 @@ def get_range(
 
         """
         symbols_list = optional_symbols_list_to_list(symbols, SType.RAW_SYMBOL)
-
-        if isinstance(events, str):
-            events = events.strip().strip(",").split(",")
+        events = optional_string_to_list(events)
+        countries = optional_string_to_list(countries)
+        security_types = optional_string_to_list(security_types)
 
         data: dict[str, object | None] = {
             "start": datetime_to_string(start),
             "end": optional_datetime_to_string(end),
+            "index": index,
             "symbols": ",".join(symbols_list),
             "stype_in": stype_in,
             "events": ",".join(events) if events else None,
-            "us_only": us_only,
+            "countries": ",".join(countries) if countries else None,
+            "security_types": ",".join(security_types) if security_types else None,
         }
 
         response = self._post(
@@ -96,7 +121,35 @@ def get_range(
         )
 
         df = pd.read_json(StringIO(response.text), lines=True)
+        if df.empty:
+            return df
+
         convert_datetime_columns(df, CORPORATE_ACTIONS_DATETIME_COLUMNS)
         convert_date_columns(df, CORPORATE_ACTIONS_DATE_COLUMNS)
 
+        if flatten:
+            # Normalize the dynamic JSON fields
+            date_info_normalized = pd.json_normalize(df["date_info"]).set_index(df.index)
+            rate_info_normalized = pd.json_normalize(df["rate_info"]).set_index(df.index)
+            event_info_normalized = pd.json_normalize(df["event_info"]).set_index(df.index)
+
+            # Merge normalized columns
+            df = df.merge(date_info_normalized, left_index=True, right_index=True)
+            df = df.merge(rate_info_normalized, left_index=True, right_index=True)
+            df = df.merge(event_info_normalized, left_index=True, right_index=True)
+
+            # Drop the original JSON columns
+            df.drop(columns=["date_info", "rate_info", "event_info"], inplace=True)
+
+        if pit:
+            df.set_index(index, inplace=True)
+            df.sort_index(inplace=True)
+        else:
+            # Filter for the latest record of each unique event
+            df.sort_values("ts_record", inplace=True)
+            df = df.groupby("event_unique_id").agg("last").reset_index()
+            df.set_index(index, inplace=True)
+            if index != "ts_record":
+                df.sort_index(inplace=True)
+
         return df
diff --git a/examples/reference_corporate_actions.py b/examples/reference_corporate_actions.py
@@ -14,7 +14,7 @@
         start="2023",
         end="2024-04",
         events="DIV,LIQ",
-        us_only=True,
+        countries="US",
     )
 
     pprint(response.head())
diff --git a/tests/data/REFERENCE/test_data.corporate-actions-pit.ndjson b/tests/data/REFERENCE/test_data.corporate-actions-pit.ndjson
@@ -0,0 +1,2 @@
+{"ts_record":"2023-10-10T04:37:14Z","event_unique_id":"U-40179043276-1888618","event_id":"E-9043276-RSPLT","listing_id":"L-1888618","listing_group_id":"LG-888618","security_id":"S-799713","issuer_id":"I-119138","event_action":"U","event":"RSPLT","event_subtype":"CONSD","event_date_label":"ex_date","event_date":"2023-10-10","event_created_date":"2023-02-09","effective_date":null,"ex_date":"2023-10-10","record_date":null,"record_date_id":"D-9043276","related_event":null,"related_event_id":null,"global_status":"A","listing_status":"T","listing_source":"M","listing_date":"2008-03-18","delisting_date":null,"issuer_name":"Bowmo Inc","security_type":"EQS","security_description":"Ordinary Shares","primary_exchange":"USOTC","exchange":"USOTC","operating_mic":"OTCM","symbol":"BOMO","nasdaq_symbol":"BOMO","local_code":"BOMO","isin":"US2288912064","us_code":"228891206","bbg_comp_id":"BBG000VCV3H9","bbg_comp_ticker":"BOMO US","figi":"BBG000VCV726","figi_ticker":"BOMO UV","listing_country":"US","register_country":"US","trading_currency":"USD","multi_currency":false,"segment_mic_name":"Pink Current Information","segment_mic":"PINC","mand_volu_flag":"M","rd_priority":1,"lot_size":100,"par_value":0.01,"par_value_currency":"USD","payment_date":null,"duebills_redemption_date":null,"from_date":null,"to_date":null,"registration_date":null,"start_date":null,"end_date":null,"open_date":null,"close_date":null,"start_subscription_date":null,"end_subscription_date":null,"option_election_date":null,"withdrawal_rights_from_date":null,"withdrawal_rights_to_date":null,"notification_date":null,"financial_year_end_date":null,"exp_completion_date":null,"payment_type":"S","option_id":"1","serial_id":"1","default_option_flag":true,"rate_currency":"USD","ratio_old":1000.0,"ratio_new":1.0,"fraction":null,"outturn_style":"NEWO","outturn_security_type":"EQS","outturn_security_id":"S-799713","outturn_isin":"US2288913054","outturn_us_code":"228891305","outturn_local_code":"BOMOD","outturn_bbg_comp_id":"BBG000VCV3H9","outturn_bbg_comp_ticker":"BOMO US","outturn_figi":"BBG000VCV726","outturn_figi_ticker":"BOMO UV","min_offer_qty":null,"max_offer_qty":null,"min_qualify_qty":null,"max_qualify_qty":null,"min_accept_qty":null,"max_accept_qty":null,"tender_strike_price":null,"tender_price_step":null,"option_expiry_time":null,"option_expiry_tz":null,"withdrawal_rights_flag":null,"withdrawal_rights_expiry_time":null,"withdrawal_rights_expiry_tz":null,"expiry_time":null,"expiry_tz":null,"date_info":{},"rate_info":{"par_value_old":0.01,"par_value_new":0.01},"event_info":{},"ts_created":"2024-07-22T01:43:15.099184Z"}
+{"ts_record":"2023-11-01T00:00:00Z","event_unique_id":"U-40179043276-1888618","event_id":"E-9043276-RSPLT","listing_id":"L-1888618","listing_group_id":"LG-888618","security_id":"S-799713","issuer_id":"I-119138","event_action":"U","event":"RSPLT","event_subtype":"CONSD","event_date_label":"ex_date","event_date":"2023-10-10","event_created_date":"2023-02-09","effective_date":null,"ex_date":"2023-10-10","record_date":null,"record_date_id":"D-9043276","related_event":null,"related_event_id":null,"global_status":"A","listing_status":"T","listing_source":"M","listing_date":"2008-03-18","delisting_date":null,"issuer_name":"Bowmo Inc","security_type":"EQS","security_description":"Ordinary Shares","primary_exchange":"USOTC","exchange":"USOTC","operating_mic":"OTCM","symbol":"BOMO","nasdaq_symbol":"BOMO","local_code":"BOMO","isin":"US2288912064","us_code":"228891206","bbg_comp_id":"BBG000VCV3H9","bbg_comp_ticker":"BOMO US","figi":"BBG000VCV726","figi_ticker":"BOMO UV","listing_country":"US","register_country":"US","trading_currency":"USD","multi_currency":false,"segment_mic_name":"Pink Current Information","segment_mic":"PINC","mand_volu_flag":"M","rd_priority":1,"lot_size":100,"par_value":0.01,"par_value_currency":"USD","payment_date":null,"duebills_redemption_date":null,"from_date":null,"to_date":null,"registration_date":null,"start_date":null,"end_date":null,"open_date":null,"close_date":null,"start_subscription_date":null,"end_subscription_date":null,"option_election_date":null,"withdrawal_rights_from_date":null,"withdrawal_rights_to_date":null,"notification_date":null,"financial_year_end_date":null,"exp_completion_date":null,"payment_type":"S","option_id":"1","serial_id":"1","default_option_flag":true,"rate_currency":"USD","ratio_old":1000.0,"ratio_new":1.0,"fraction":null,"outturn_style":"NEWO","outturn_security_type":"EQS","outturn_security_id":"S-799713","outturn_isin":"US2288913054","outturn_us_code":"228891305","outturn_local_code":"BOMOD","outturn_bbg_comp_id":"BBG000VCV3H9","outturn_bbg_comp_ticker":"BOMO US","outturn_figi":"BBG000VCV726","outturn_figi_ticker":"BOMO UV","min_offer_qty":null,"max_offer_qty":null,"min_qualify_qty":null,"max_qualify_qty":null,"min_accept_qty":null,"max_accept_qty":null,"tender_strike_price":null,"tender_price_step":null,"option_expiry_time":null,"option_expiry_tz":null,"withdrawal_rights_flag":null,"withdrawal_rights_expiry_time":null,"withdrawal_rights_expiry_tz":null,"expiry_time":null,"expiry_tz":null,"date_info":{},"rate_info":{"par_value_old":0.01,"par_value_new":0.01},"event_info":{},"ts_created":"2024-07-23T00:00:00.000000Z"}
diff --git a/tests/test_reference_corporate.py b/tests/test_reference_corporate.py
@@ -5,6 +5,7 @@
 from unittest.mock import MagicMock
 
 import databento as db
+import pandas as pd
 import pytest
 import requests
 from databento.reference.client import Reference
@@ -13,35 +14,66 @@
 
 
 @pytest.mark.parametrize(
-    ("events", "data_events"),
+    (
+        "events",
+        "countries",
+        "security_types",
+        "expected_events",
+        "expected_countries",
+        "expected_security_types",
+    ),
     [
         [
             None,
             None,
+            None,
+            None,
+            None,
+            None,
         ],
         [
             [],
+            [],
+            [],
+            None,
+            None,
             None,
         ],
         [
             "DIV",
+            "US",
+            "EQS",
             "DIV",
+            "US",
+            "EQS",
         ],
         [
             "DIV,LIQ",
+            "US,CA",
+            "EQS,ETF",
             "DIV,LIQ",
+            "US,CA",
+            "EQS,ETF",
         ],
         [
             ["DIV", "LIQ"],
+            ["US", "CA"],
+            ["EQS", "ETF"],
             "DIV,LIQ",
+            "US,CA",
+            "EQS,ETF",
         ],
     ],
 )
 def test_corporate_actions_get_range_sends_expected_request(
     monkeypatch: pytest.MonkeyPatch,
     reference_client: Reference,
     events: Iterable[str] | str | None,
-    data_events: str,
+    countries: Iterable[str] | str | None,
+    security_types: Iterable[str] | str | None,
+    expected_events: str,
+    expected_countries: str,
+    expected_security_types: str,
 ) -> None:
     # Arrange
     mock_response = MagicMock()
@@ -57,6 +89,8 @@ def test_corporate_actions_get_range_sends_expected_request(
         start="2024-01",
         end="2024-04",
         events=events,
+        countries=countries,
+        security_types=security_types,
     )
 
     # Assert
@@ -70,16 +104,108 @@ def test_corporate_actions_get_range_sends_expected_request(
     assert call["data"] == {
         "start": "2024-01",
         "end": "2024-04",
+        "index": "event_date",
         "symbols": "AAPL",
         "stype_in": "raw_symbol",
-        "events": data_events,
-        "us_only": False,
+        "events": expected_events,
+        "countries": expected_countries,
+        "security_types": expected_security_types,
     }
     assert call["timeout"] == (100, 100)
     assert isinstance(call["auth"], requests.auth.HTTPBasicAuth)
 
 
-def test_corporate_actions_get_range_response_parsing(
+def test_corporate_actions_get_range_response_parsing_as_pit(
+    monkeypatch: pytest.MonkeyPatch,
+    reference_client: Reference,
+) -> None:
+    # Arrange
+    data_path = Path(TESTS_ROOT) / "data" / "REFERENCE" / "test_data.corporate-actions.ndjson"
+    mock_response = MagicMock()
+    mock_response.text = data_path.read_text()
+    mock_response.__enter__.return_value = mock_response
+    mock_response.__exit__ = MagicMock()
+    monkeypatch.setattr(requests, "post", MagicMock(return_value=mock_response))
+
+    # Act
+    df_raw = reference_client.corporate_actions.get_range(
+        symbols="AAPL",
+        stype_in="raw_symbol",
+        start="2024-01",
+        end="2024-04",
+        pit=True,
+    )
+
+    # Assert
+    assert len(df_raw) == 2
+    assert df_raw.index.name == "event_date"
+    assert df_raw.index.is_monotonic_increasing
+    # Assert the columns were dropped
+    for col in ["date_info", "rate_info", "event_info"]:
+        assert col not in df_raw.columns
+
+
+def test_corporate_actions_get_range_response(
+    monkeypatch: pytest.MonkeyPatch,
+    reference_client: Reference,
+) -> None:
+    # Arrange
+    data_path = Path(TESTS_ROOT) / "data" / "REFERENCE" / "test_data.corporate-actions-pit.ndjson"
+    mock_response = MagicMock()
+    mock_response.text = data_path.read_text()
+    mock_response.__enter__.return_value = mock_response
+    mock_response.__exit__ = MagicMock()
+    monkeypatch.setattr(requests, "post", MagicMock(return_value=mock_response))
+
+    # Act
+    df_raw = reference_client.corporate_actions.get_range(
+        symbols="AAPL",
+        index="ts_record",
+        start="2024-01",
+        end="2024-04",
+        pit=False,
+    )
+
+    # Assert
+    assert len(df_raw) == 1
+    assert df_raw.index[0] == pd.Timestamp("2023-11-01 00:00:00", tz="UTC")
+
+
+def test_corporate_actions_get_range_with_ts_record_index(
+    monkeypatch: pytest.MonkeyPatch,
+    reference_client: Reference,
+) -> None:
+    # Arrange
+    data_path = Path(TESTS_ROOT) / "data" / "REFERENCE" / "test_data.corporate-actions.ndjson"
+    mock_response = MagicMock()
+    mock_response.text = data_path.read_text()
+    mock_response.__enter__.return_value = mock_response
+    mock_response.__exit__ = MagicMock()
+    monkeypatch.setattr(requests, "post", MagicMock(return_value=mock_response))
+
+    # Act
+    df_raw = reference_client.corporate_actions.get_range(
+        symbols="AAPL",
+        stype_in="raw_symbol",
+        index="ts_record",
+        start="2024-01",
+        end="2024-04",
+    )
+
+    expected_index = pd.DatetimeIndex(
+        [
+            "2023-10-10 04:37:14+00:00",
+            "2023-10-10 04:37:14+00:00",
+        ],
+        name="ts_record",
+    )
+
+    # Assert
+    assert len(df_raw) == 2
+    assert df_raw.index.equals(expected_index)
+
+
+def test_corporate_actions_get_range_without_flattening(
     monkeypatch: pytest.MonkeyPatch,
     reference_client: Reference,
 ) -> None:
@@ -97,7 +223,11 @@ def test_corporate_actions_get_range_response_parsing(
         stype_in="raw_symbol",
         start="2024-01",
         end="2024-04",
+        flatten=False,
     )
 
     # Assert
     assert len(df_raw) == 2
+    # Assert the columns were retained
+    for col in ["date_info", "rate_info", "event_info"]:
+        assert col in df_raw.columns

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@`
`14`	`14`	`start="2023",`
`15`	`15`	`end="2024-04",`
`16`	`16`	`events="DIV,LIQ",`
`17`		`- us_only=True,`
	`17`	`+ countries="US",`
`18`	`18`	`)`
`19`	`19`
`20`	`20`	`pprint(response.head())`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	+{"ts_record":"2023-10-10T04:37:14Z","event_unique_id":"U-40179043276-1888618","event_id":"E-9043276-RSPLT","listing_id":"L-1888618","listing_group_id":"LG-888618","security_id":"S-799713","issuer_id":"I-119138","event_action":"U","event":"RSPLT","event_subtype":"CONSD","event_date_label":"ex_date","event_date":"2023-10-10","event_created_date":"2023-02-09","effective_date":null,"ex_date":"2023-10-10","record_date":null,"record_date_id":"D-9043276","related_event":null,"related_event_id":null,"global_status":"A","listing_status":"T","listing_source":"M","listing_date":"2008-03-18","delisting_date":null,"issuer_name":"Bowmo Inc","security_type":"EQS","security_description":"Ordinary Shares","primary_exchange":"USOTC","exchange":"USOTC","operating_mic":"OTCM","symbol":"BOMO","nasdaq_symbol":"BOMO","local_code":"BOMO","isin":"US2288912064","us_code":"228891206","bbg_comp_id":"BBG000VCV3H9","bbg_comp_ticker":"BOMO US","figi":"BBG000VCV726","figi_ticker":"BOMO UV","listing_country":"US","register_country":"US","trading_currency":"USD","multi_currency":false,"segment_mic_name":"Pink Current Information","segment_mic":"PINC","mand_volu_flag":"M","rd_priority":1,"lot_size":100,"par_value":0.01,"par_value_currency":"USD","payment_date":null,"duebills_redemption_date":null,"from_date":null,"to_date":null,"registration_date":null,"start_date":null,"end_date":null,"open_date":null,"close_date":null,"start_subscription_date":null,"end_subscription_date":null,"option_election_date":null,"withdrawal_rights_from_date":null,"withdrawal_rights_to_date":null,"notification_date":null,"financial_year_end_date":null,"exp_completion_date":null,"payment_type":"S","option_id":"1","serial_id":"1","default_option_flag":true,"rate_currency":"USD","ratio_old":1000.0,"ratio_new":1.0,"fraction":null,"outturn_style":"NEWO","outturn_security_type":"EQS","outturn_security_id":"S-799713","outturn_isin":"US2288913054","outturn_us_code":"228891305","outturn_local_code":"BOMOD","outturn_bbg_comp_id":"BBG000VCV3H9","outturn_bbg_comp_ticker":"BOMO US","outturn_figi":"BBG000VCV726","outturn_figi_ticker":"BOMO UV","min_offer_qty":null,"max_offer_qty":null,"min_qualify_qty":null,"max_qualify_qty":null,"min_accept_qty":null,"max_accept_qty":null,"tender_strike_price":null,"tender_price_step":null,"option_expiry_time":null,"option_expiry_tz":null,"withdrawal_rights_flag":null,"withdrawal_rights_expiry_time":null,"withdrawal_rights_expiry_tz":null,"expiry_time":null,"expiry_tz":null,"date_info":{},"rate_info":{"par_value_old":0.01,"par_value_new":0.01},"event_info":{},"ts_created":"2024-07-22T01:43:15.099184Z"}
	`2`	+{"ts_record":"2023-11-01T00:00:00Z","event_unique_id":"U-40179043276-1888618","event_id":"E-9043276-RSPLT","listing_id":"L-1888618","listing_group_id":"LG-888618","security_id":"S-799713","issuer_id":"I-119138","event_action":"U","event":"RSPLT","event_subtype":"CONSD","event_date_label":"ex_date","event_date":"2023-10-10","event_created_date":"2023-02-09","effective_date":null,"ex_date":"2023-10-10","record_date":null,"record_date_id":"D-9043276","related_event":null,"related_event_id":null,"global_status":"A","listing_status":"T","listing_source":"M","listing_date":"2008-03-18","delisting_date":null,"issuer_name":"Bowmo Inc","security_type":"EQS","security_description":"Ordinary Shares","primary_exchange":"USOTC","exchange":"USOTC","operating_mic":"OTCM","symbol":"BOMO","nasdaq_symbol":"BOMO","local_code":"BOMO","isin":"US2288912064","us_code":"228891206","bbg_comp_id":"BBG000VCV3H9","bbg_comp_ticker":"BOMO US","figi":"BBG000VCV726","figi_ticker":"BOMO UV","listing_country":"US","register_country":"US","trading_currency":"USD","multi_currency":false,"segment_mic_name":"Pink Current Information","segment_mic":"PINC","mand_volu_flag":"M","rd_priority":1,"lot_size":100,"par_value":0.01,"par_value_currency":"USD","payment_date":null,"duebills_redemption_date":null,"from_date":null,"to_date":null,"registration_date":null,"start_date":null,"end_date":null,"open_date":null,"close_date":null,"start_subscription_date":null,"end_subscription_date":null,"option_election_date":null,"withdrawal_rights_from_date":null,"withdrawal_rights_to_date":null,"notification_date":null,"financial_year_end_date":null,"exp_completion_date":null,"payment_type":"S","option_id":"1","serial_id":"1","default_option_flag":true,"rate_currency":"USD","ratio_old":1000.0,"ratio_new":1.0,"fraction":null,"outturn_style":"NEWO","outturn_security_type":"EQS","outturn_security_id":"S-799713","outturn_isin":"US2288913054","outturn_us_code":"228891305","outturn_local_code":"BOMOD","outturn_bbg_comp_id":"BBG000VCV3H9","outturn_bbg_comp_ticker":"BOMO US","outturn_figi":"BBG000VCV726","outturn_figi_ticker":"BOMO UV","min_offer_qty":null,"max_offer_qty":null,"min_qualify_qty":null,"max_qualify_qty":null,"min_accept_qty":null,"max_accept_qty":null,"tender_strike_price":null,"tender_price_step":null,"option_expiry_time":null,"option_expiry_tz":null,"withdrawal_rights_flag":null,"withdrawal_rights_expiry_time":null,"withdrawal_rights_expiry_tz":null,"expiry_time":null,"expiry_tz":null,"date_info":{},"rate_info":{"par_value_old":0.01,"par_value_new":0.01},"event_info":{},"ts_created":"2024-07-23T00:00:00.000000Z"}