morphiq-sdk 0.1.0__tar.gz → 0.2.0__tar.gz

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: morphiq-sdk
-Version: 0.1.0
+Version: 0.2.0
 Summary: Option pricing, Greeks, implied volatility and market regime identification through a Python API client
 Project-URL: Homepage, https://developers.morphiqlabs.com
 Project-URL: Documentation, https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/README.md
@@ -36,7 +36,7 @@ Description-Content-Type: text/markdown
 
 # Option pricing, Greeks, volatility and market regimes in Python
 
-Price European and American options, calculate ten Greeks, solve implied
+Price European and American options, calculate standard-five or all-ten Greeks, solve implied
 volatility, and identify market regimes from price histories.
 
 `morphiq-sdk` is a typed Python client for the MorphIQ API, with synchronous and
@@ -47,6 +47,12 @@ valuation, sensitivity analysis and market-regime identification.
 See the [documentation index](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/README.md) for all feature guides and the
 [Python API reference](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/API.md) for methods, models and errors.
 
+This client targets API **v0.5.0**, including public model discovery,
+standard-five Greeks, cost utilities and spend caps. SDK 0.1.x lacks these
+additions; use the release containing this contract update or install this checkout.
+See [model capabilities and migration](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/MODELS.md): BSM/BS1993 support batches
+up to 100; QdFp and cash-dividend finite difference support single price and IV.
+
 ## Quickstart
 
 ### 1. Get API access
@@ -106,26 +112,26 @@ and prints the JSON response. Example response from the recorded synthetic fixtu
 
 ```json
 {
-  "result": {
-    "price": 10.450583572185538,
-    "exercise_style": "european",
-    "option_type": "call",
-    "pricing_model": "black_scholes_merton",
-    "model_version": "black_scholes_merton/1"
-  },
   "metadata": {
-    "request_id": "fixture-european",
+    "request_id": "fr-18e4e90129262501-0000000000000003",
     "api_version": "v1",
-    "engine_version": "0.39.1",
+    "engine_version": "0.43.5",
     "engines": [
       {
         "name": "morphiq-risk",
-        "version": "0.39.1",
-        "revision": "b4c29d492ff96dddf9b25f745d2be4d253202164"
+        "version": "0.43.5",
+        "revision": "43ca7f93b9edda6078b49950de6a8b7d51a3e3ef"
       }
     ],
     "units_charged": 1,
     "compute_schedule_version": "2026-09-11"
+  },
+  "result": {
+    "price": 10.45058357218557,
+    "exercise_style": "european",
+    "option_type": "call",
+    "pricing_model": "black_scholes_merton",
+    "model_version": "black_scholes_merton/1"
   }
 }
 ```
@@ -218,8 +224,10 @@ no real credentials; native API integration is opt-in. See
 [CONTRIBUTING.md](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/CONTRIBUTING.md) and [RELEASE.md](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/RELEASE.md).
 
 Clients make no automatic retries and do not follow redirects. A timeout
-may leave work charged. Missing `fcu_charged` means unreported, not zero; internal
-`units_charged` is not a commercial CU charge.
+may leave work charged. Only `fcu_quoted` and `fcu_charged` report commercial CUs.
+Missing `fcu_charged` means unreported, not zero. The retired `units_charged` and
+`compute_schedule_version` fields are optional; they remain accepted from older
+deployments and are never used to calculate a charge.
 
 The SDK preserves server results, numerical diagnostics, request IDs, engine
 provenance and commercial Compute Units (CU). Numerical engines, model selection,
@@ -243,3 +251,5 @@ docs/              Usage guides and contract documentation
 
 The SDK, examples and notebooks are licensed under the
 [MIT License](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/LICENSE).
+
+See [cost schedules and request quotes](docs/COST.md) for zero-CU discovery, conditional quotes, and the optional `max_cu` execution ceiling.

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # Option pricing, Greeks, volatility and market regimes in Python
 
-Price European and American options, calculate ten Greeks, solve implied
+Price European and American options, calculate standard-five or all-ten Greeks, solve implied
 volatility, and identify market regimes from price histories.
 
 `morphiq-sdk` is a typed Python client for the MorphIQ API, with synchronous and
@@ -11,6 +11,12 @@ valuation, sensitivity analysis and market-regime identification.
 See the [documentation index](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/README.md) for all feature guides and the
 [Python API reference](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/API.md) for methods, models and errors.
 
+This client targets API **v0.5.0**, including public model discovery,
+standard-five Greeks, cost utilities and spend caps. SDK 0.1.x lacks these
+additions; use the release containing this contract update or install this checkout.
+See [model capabilities and migration](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/MODELS.md): BSM/BS1993 support batches
+up to 100; QdFp and cash-dividend finite difference support single price and IV.
+
 ## Quickstart
 
 ### 1. Get API access
@@ -70,26 +76,26 @@ and prints the JSON response. Example response from the recorded synthetic fixtu
 
 ```json
 {
-  "result": {
-    "price": 10.450583572185538,
-    "exercise_style": "european",
-    "option_type": "call",
-    "pricing_model": "black_scholes_merton",
-    "model_version": "black_scholes_merton/1"
-  },
   "metadata": {
-    "request_id": "fixture-european",
+    "request_id": "fr-18e4e90129262501-0000000000000003",
     "api_version": "v1",
-    "engine_version": "0.39.1",
+    "engine_version": "0.43.5",
     "engines": [
       {
         "name": "morphiq-risk",
-        "version": "0.39.1",
-        "revision": "b4c29d492ff96dddf9b25f745d2be4d253202164"
+        "version": "0.43.5",
+        "revision": "43ca7f93b9edda6078b49950de6a8b7d51a3e3ef"
       }
     ],
     "units_charged": 1,
     "compute_schedule_version": "2026-09-11"
+  },
+  "result": {
+    "price": 10.45058357218557,
+    "exercise_style": "european",
+    "option_type": "call",
+    "pricing_model": "black_scholes_merton",
+    "model_version": "black_scholes_merton/1"
   }
 }
 ```
@@ -182,8 +188,10 @@ no real credentials; native API integration is opt-in. See
 [CONTRIBUTING.md](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/CONTRIBUTING.md) and [RELEASE.md](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/RELEASE.md).
 
 Clients make no automatic retries and do not follow redirects. A timeout
-may leave work charged. Missing `fcu_charged` means unreported, not zero; internal
-`units_charged` is not a commercial CU charge.
+may leave work charged. Only `fcu_quoted` and `fcu_charged` report commercial CUs.
+Missing `fcu_charged` means unreported, not zero. The retired `units_charged` and
+`compute_schedule_version` fields are optional; they remain accepted from older
+deployments and are never used to calculate a charge.
 
 The SDK preserves server results, numerical diagnostics, request IDs, engine
 provenance and commercial Compute Units (CU). Numerical engines, model selection,
@@ -207,3 +215,5 @@ docs/              Usage guides and contract documentation
 
 The SDK, examples and notebooks are licensed under the
 [MIT License](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/LICENSE).
+
+See [cost schedules and request quotes](docs/COST.md) for zero-CU discovery, conditional quotes, and the optional `max_cu` execution ceiling.

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/analytics.py

@@ -75,7 +75,9 @@ def main() -> None:
         "veta",
         "color",
     ):
-        print(f"  {name}: {getattr(response.result.greeks, name)}")
+        value = getattr(response.result.greeks, name)
+        reason = response.result.greeks.unavailable.get(name)
+        print(f"  {name}: {value if value is not None else reason}")
     # The combined response reports one charge, not one charge per result component.
     print(f"Model: {response.result.pricing_model} ({response.result.model_version})")
     print(f"Request ID: {response.metadata.request_id}")

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/analytics_async.py

@@ -82,7 +82,9 @@ async def main() -> None:
         "veta",
         "color",
     ):
-        print(f"  {name}: {getattr(response.result.greeks, name)}")
+        value = getattr(response.result.greeks, name)
+        reason = response.result.greeks.unavailable.get(name)
+        print(f"  {name}: {value if value is not None else reason}")
     # The combined response reports one charge, not one charge per result component.
     print(f"Model: {response.result.pricing_model} ({response.result.model_version})")
     print(f"Request ID: {response.metadata.request_id}")

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/batch_price.py

@@ -38,7 +38,7 @@ def main() -> None:
             ),
             PriceRequest(
                 exercise_style="american",
-                pricing_model="auto",
+                pricing_model="bjerksund_stensland_1993",
                 option_type="put",
                 spot=100.0,
                 strike=105.0,

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/batch_price_async.py

@@ -39,7 +39,7 @@ async def main() -> None:
             ),
             PriceRequest(
                 exercise_style="american",
-                pricing_model="auto",
+                pricing_model="bjerksund_stensland_1993",
                 option_type="put",
                 spot=100.0,
                 strike=105.0,

morphiq_sdk-0.2.0/examples/cost_quote.py

@@ -0,0 +1,77 @@
+"""Two non-billable utility requests; --execute adds one capped pricing request."""
+
+import argparse
+import sys
+
+from morphiq_sdk import (
+    APIError,
+    BatchPriceRequest,
+    BatchPriceResponse,
+    MorphIQ,
+    PriceRequest,
+    PriceResponse,
+)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--execute", action="store_true", help="Execute once with the quoted CU ceiling"
+    )
+    parser.add_argument("--batch", action="store_true", help="Quote two synthetic contracts")
+    parser.add_argument(
+        "--max-cu", type=int, help="Explicit execution ceiling; defaults to the quote"
+    )
+    args = parser.parse_args()
+    if args.max_cu is not None and not 0 <= args.max_cu <= 2**64 - 1:
+        parser.error("--max-cu must be an unsigned 64-bit integer")
+    if args.max_cu is not None and not args.execute:
+        parser.error("--max-cu requires --execute")
+    request = PriceRequest(
+        exercise_style="european",
+        option_type="call",
+        spot=100.0,
+        strike=100.0,
+        time_to_expiry_years=1.0,
+        risk_free_rate=0.05,
+        dividend_yield=0.0,
+        volatility=0.2,
+    )
+    with MorphIQ() as client:
+        schedule = client.cost_schedule(operation="price")
+        print(schedule.model_dump_json(indent=2))
+        batch = BatchPriceRequest(requests=[request, request])
+        quote = client.quote(batch if args.batch else request)
+        print(quote.model_dump_json(indent=2))
+        print("Prospective execution CU:", quote.quote.total_fcu)
+        print("Utility CU charged:", quote.metadata.fcu_charged)
+        if args.execute:
+            ceiling = quote.quote.total_fcu if args.max_cu is None else args.max_cu
+            response: PriceResponse | BatchPriceResponse
+            try:
+                if args.batch:
+                    response = client.price_batch(batch, max_cu=ceiling)
+                else:
+                    response = client.price(request, max_cu=ceiling)
+            except APIError as error:
+                print(f"HTTP {error.status_code}: {error.code}", file=sys.stderr)
+                print("Request ID:", error.request_id, file=sys.stderr)
+                quoted = error.metadata.fcu_quoted if error.metadata else None
+                charged = error.metadata.fcu_charged if error.metadata else None
+                print(
+                    "Execution quote CU:",
+                    quoted if quoted is not None else "not reported",
+                    file=sys.stderr,
+                )
+                print(
+                    "CU charged:",
+                    charged if charged is not None else "not reported",
+                    file=sys.stderr,
+                )
+                print("No retry or automatic ceiling increase.", file=sys.stderr)
+                raise SystemExit(1) from None
+            print(response.model_dump_json(indent=2))
+
+
+if __name__ == "__main__":
+    main()

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/greeks.py

@@ -65,7 +65,9 @@ def main() -> None:
         "veta",
         "color",
     ):
-        print(f"  {name}: {getattr(response.result.greeks, name)}")
+        value = getattr(response.result.greeks, name)
+        reason = response.result.greeks.unavailable.get(name)
+        print(f"  {name}: {value if value is not None else reason}")
     print(f"Model: {response.result.pricing_model} ({response.result.model_version})")
     print(f"Request ID: {response.metadata.request_id}")
     for engine in response.metadata.engines:

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/examples/greeks_async.py

@@ -66,7 +66,9 @@ async def main() -> None:
         "veta",
         "color",
     ):
-        print(f"  {name}: {getattr(response.result.greeks, name)}")
+        value = getattr(response.result.greeks, name)
+        reason = response.result.greeks.unavailable.get(name)
+        print(f"  {name}: {value if value is not None else reason}")
     print(f"Model: {response.result.pricing_model} ({response.result.model_version})")
     print(f"Request ID: {response.metadata.request_id}")
     for engine in response.metadata.engines:

morphiq_sdk-0.2.0/examples/greeks_standard.py

@@ -0,0 +1,76 @@
+"""Calculate the price and standard five Greeks for a synthetic European call.
+
+Run: python examples/greeks_standard.py
+"""
+
+import os
+import sys
+from getpass import getpass
+
+from morphiq_sdk import APIError, GreeksStandardRequest, MorphIQ, ResponseError, TransportError
+
+
+def main() -> None:
+    # Set MORPHIQ_API_KEY in your environment, or enter it at the masked prompt.
+    api_key = os.environ.get("MORPHIQ_API_KEY") or getpass("MorphIQ API key: ")
+
+    # Synthetic European call; spot and strike use the same currency.
+    request = GreeksStandardRequest(
+        exercise_style="european",
+        option_type="call",
+        spot=100.0,
+        strike=100.0,
+        time_to_expiry_years=1.0,  # Years from valuation.
+        risk_free_rate=0.05,  # 5% annual rate.
+        dividend_yield=0.0,
+        volatility=0.20,  # 20% annual volatility.
+        pricing_model="auto",
+    )
+
+    try:
+        # The client uses https://api.morphiqlabs.com and closes its connection pool here.
+        with MorphIQ(api_key=api_key) as client:
+            response = client.greeks_standard(request)
+    except APIError as error:
+        print(f"HTTP {error.status_code}: {error.code}: {error.message}", file=sys.stderr)
+        print(f"Request ID: {error.request_id}", file=sys.stderr)
+        charged = error.metadata.fcu_charged if error.metadata else None
+        print(
+            f"Commercial CU charged: {charged if charged is not None else 'not reported'}",
+            file=sys.stderr,
+        )
+        raise SystemExit(1) from None
+    except TransportError:
+        # Includes timeouts. The service may already have committed a charge.
+        raise SystemExit(
+            "No complete response; execution and charges may be unknown. No retry."
+        ) from None
+    except ResponseError as error:
+        raise SystemExit(
+            f"Invalid response; request_id={error.request_id}. Charges may be unknown. No retry."
+        ) from None
+
+    print(f"Price: {response.result.price}")
+    # API time derivatives are per year; vega/rho use unit volatility/rate.
+    print("Greeks (raw API units):")
+    for name in (
+        "delta",
+        "gamma",
+        "theta",
+        "vega",
+        "rho",
+    ):
+        value = getattr(response.result.greeks, name)
+        reason = response.result.greeks.unavailable.get(name)
+        print(f"  {name}: {value if value is not None else reason}")
+    print(f"Model: {response.result.pricing_model} ({response.result.model_version})")
+    print(f"Request ID: {response.metadata.request_id}")
+    for engine in response.metadata.engines:
+        print(f"Engine: {engine.name} {engine.version} ({engine.revision})")
+    # Missing commercial CU is unreported, not zero.
+    charged = response.metadata.fcu_charged
+    print("Commercial CU charged:", charged if charged is not None else "not reported")
+
+
+if __name__ == "__main__":
+    main()

morphiq_sdk-0.2.0/examples/pricing_models.py

@@ -0,0 +1,17 @@
+"""Inspect public model capabilities with one unauthenticated request."""
+
+from morphiq_sdk import MorphIQ
+
+
+def main() -> None:
+    with MorphIQ() as client:
+        response = client.pricing_models()
+    for model in response.models:
+        print(model.id, model.operations, model.batch_operations)
+        print("Constraints:", [item.model_dump(exclude_unset=True) for item in model.constraints])
+    print("Engines:", [item.model_dump() for item in response.engines])
+    print("Greek units:", response.greek_units)
+
+
+if __name__ == "__main__":
+    main()

{morphiq_sdk-0.1.0 → morphiq_sdk-0.2.0}/notebooks/README.md

@@ -5,6 +5,9 @@ Use the controls to load data and run an analysis; no code edits are required.
 
 | Workspace | Tools | API requests per action |
 | --- | --- | --- |
+| [Available models](pricing/models.ipynb) | Public capabilities, aliases, constraints and engine versions; no key needed | Load: 1 free request |
+| [Standard-five Greeks](pricing/standard-five.ipynb) | BSM/BS1993 inputs, price, five primary sensitivities, unavailable reasons and CU | Calculate: 1 |
+| [Cost quotation](cost/quotation.ipynb) | Account rates, synthetic option inputs, conditional quote, editable execution ceiling | Schedule: 1 utility; quote: 1 utility; execute: 1 capped pricing request |
 | [Option pricing](pricing/options.ipynb) | European/American and model selectors, call/put, option inputs, automatic Yahoo daily/intraday underlying prices, comparison table, all-ten-Greeks panel, implied-volatility solver, combined premium analysis, session CU ledger, spot-sensitivity chart | Price: 1; price + Greeks: 1; solve IV: 1; analyze premium: 1; sensitivity: 1 batch of 9 items |
 | [Regime analysis](regime/identification.ipynb) | Ticker and interval selection, one-click Yahoo history download and analysis, price-history chart, latest regime assessment, score charts, provenance | Analyze: 1 |
 

morphiq_sdk-0.2.0/notebooks/cost/quotation.ipynb

@@ -0,0 +1,167 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "33ea9e49",
+      "metadata": {},
+      "source": [
+        "# Explore request costs\n",
+        "\n",
+        "MorphIQ SDK for Python\n\n",
+        "Inspect your account’s rates, quote an option, then choose whether to execute.\n",
+        "All inputs start with synthetic values. Running setup or changing a control sends\n",
+        "no requests. Schedule and Quote each send one zero-CU utility request. Execute sends\n",
+        "one pricing request with your chosen CU ceiling. A quote does not lock a price or\n",
+        "guarantee funding, capacity or numerical success.\n",
+        "\n",
+        "Set `MORPHIQ_API_KEY` before opening Jupyter, or enter it in the masked setup prompt.\n",
+        "Use a deployment supporting cost utilities. Quote again after changing inputs.\n",
+        "\n",
+        "Read the output: `total_fcu` is the prospective execution charge; the utility\n",
+        "charge printed below it is zero. Rate lines group work by billing class. A minimum\n",
+        "is a floor on the whole request, not an extra fee. The Max CU control limits the\n",
+        "next execution only. A 409 `cost_limit_exceeded` refusal commits no charge; review\n",
+        "your budget before raising the control and clicking Execute again.\n",
+        "\n",
+        "For complete response examples, batch requests and error handling, see the\n",
+        "[cost guide](https://github.com/MorphIQ-Labs/morphiq-sdk-python/blob/main/docs/COST.md).\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "8d057cc6",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import getpass\n",
+        "import os\n",
+        "\n",
+        "import ipywidgets as widgets\n",
+        "from IPython.display import display\n",
+        "\n",
+        "from morphiq_sdk import APIError, MorphIQ, PriceRequest, TransportError\n",
+        "\n",
+        "api_key = os.environ.get(\"MORPHIQ_API_KEY\") or getpass.getpass(\"MorphIQ API key: \")\n",
+        "spot = widgets.FloatText(value=100.0, description=\"Spot\")\n",
+        "strike = widgets.FloatText(value=100.0, description=\"Strike\")\n",
+        "volatility = widgets.FloatText(value=0.2, description=\"Volatility\")\n",
+        "years = widgets.FloatText(value=1.0, description=\"Years\")\n",
+        "rate = widgets.FloatText(value=0.05, description=\"Rate\")\n",
+        "yield_rate = widgets.FloatText(value=0.0, description=\"Yield\")\n",
+        "style = widgets.Dropdown(options=[\"european\", \"american\"], description=\"Exercise\")\n",
+        "option_type = widgets.Dropdown(options=[\"call\", \"put\"], description=\"Option\")\n",
+        "maximum = widgets.IntText(value=1, description=\"Max CU\")\n",
+        "schedule_button = widgets.Button(description=\"Rates · 1 utility\")\n",
+        "quote_button = widgets.Button(description=\"Quote · 1 utility\")\n",
+        "execute_button = widgets.Button(description=\"Execute · 1 request\", disabled=True)\n",
+        "output = widgets.Output()\n",
+        "last_quote = None\n",
+        "quoted_request = None\n",
+        "last_result = None\n",
+        "\n",
+        "\n",
+        "def current_request():\n",
+        "    return PriceRequest(\n",
+        "        exercise_style=style.value,\n",
+        "        option_type=option_type.value,\n",
+        "        spot=spot.value,\n",
+        "        strike=strike.value,\n",
+        "        volatility=volatility.value,\n",
+        "        time_to_expiry_years=years.value,\n",
+        "        risk_free_rate=rate.value,\n",
+        "        dividend_yield=yield_rate.value,\n",
+        "    )\n",
+        "\n",
+        "\n",
+        "def show_error(error):\n",
+        "    if isinstance(error, APIError):\n",
+        "        charged = error.metadata.fcu_charged if error.metadata else \"unknown\"\n",
+        "        print(f\"API refused: {error.status_code}; {error.code}; charged CU: {charged}\")\n",
+        "    else:\n",
+        "        print(str(error))\n",
+        "\n",
+        "\n",
+        "def show_schedule(_):\n",
+        "    with output:\n",
+        "        output.clear_output()\n",
+        "        try:\n",
+        "            with MorphIQ(api_key=api_key) as client:\n",
+        "                response = client.cost_schedule(operation=\"price\")\n",
+        "            print(response.schedule.model_dump_json(indent=2))\n",
+        "            print(\"Utility CU charged:\", response.metadata.fcu_charged)\n",
+        "        except (APIError, TransportError, ValueError) as error:\n",
+        "            show_error(error)\n",
+        "\n",
+        "\n",
+        "def quote_request(_):\n",
+        "    global last_quote, quoted_request\n",
+        "    execute_button.disabled = True\n",
+        "    last_quote = quoted_request = None\n",
+        "    with output:\n",
+        "        output.clear_output()\n",
+        "        try:\n",
+        "            request = current_request()\n",
+        "            with MorphIQ(api_key=api_key) as client:\n",
+        "                response = client.quote(request)\n",
+        "            last_quote, quoted_request = response, request.to_wire()\n",
+        "            maximum.value = response.quote.total_fcu\n",
+        "            execute_button.disabled = False\n",
+        "            print(response.quote.model_dump_json(indent=2))\n",
+        "            print(\"Selected models:\", response.resolved_models)\n",
+        "            print(\"Utility CU charged:\", response.metadata.fcu_charged)\n",
+        "            print(\"Execution is a separate action. Adjust Max CU if desired.\")\n",
+        "        except (APIError, TransportError, ValueError) as error:\n",
+        "            show_error(error)\n",
+        "\n",
+        "\n",
+        "def execute_request(_):\n",
+        "    global last_result\n",
+        "    with output:\n",
+        "        output.clear_output()\n",
+        "        try:\n",
+        "            request = current_request()\n",
+        "            if last_quote is None or request.to_wire() != quoted_request:\n",
+        "                print(\"Inputs changed. Quote this request before executing.\")\n",
+        "                return\n",
+        "            with MorphIQ(api_key=api_key) as client:\n",
+        "                last_result = client.price(request, max_cu=maximum.value)\n",
+        "            print(\"Price:\", last_result.result.price)\n",
+        "            print(\"CU charged:\", last_result.metadata.fcu_charged)\n",
+        "        except (APIError, TransportError, ValueError) as error:\n",
+        "            show_error(error)\n",
+        "\n",
+        "\n",
+        "def input_changed(_):\n",
+        "    execute_button.disabled = True\n",
+        "\n",
+        "\n",
+        "for control in [spot, strike, volatility, years, rate, yield_rate, style, option_type]:\n",
+        "    control.observe(input_changed, names=\"value\")\n",
+        "schedule_button.on_click(show_schedule)\n",
+        "quote_button.on_click(quote_request)\n",
+        "execute_button.on_click(execute_request)\n",
+        "display(\n",
+        "    widgets.VBox(\n",
+        "        [\n",
+        "            widgets.HBox([spot, strike, volatility]),\n",
+        "            widgets.HBox([years, rate, yield_rate]),\n",
+        "            widgets.HBox([style, option_type, maximum]),\n",
+        "            widgets.HBox([schedule_button, quote_button, execute_button]),\n",
+        "            output,\n",
+        "        ]\n",
+        "    )\n",
+        ")"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

morphiq_sdk-0.2.0/notebooks/pricing/models.ipynb

@@ -0,0 +1,72 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "intro",
+      "metadata": {},
+      "source": "# MorphIQ SDK for Python — Available models\n\nInspect model capabilities, aliases, constraints, engine versions and Greek units.\nRun setup once, then click **Load models — 1 request, 0 CU**. No key is needed.\nSetup makes no requests. This catalog describes compiled capabilities; use the\ncost quotation workspace for account-specific rates and admission.\n\n[Back to start](../start-here.ipynb)\n"
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "id": "workspace",
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "import ipywidgets as widgets\n",
+        "from IPython.display import display\n",
+        "\n",
+        "from morphiq_sdk import MorphIQ, MorphIQError\n",
+        "\n",
+        "load_button = widgets.Button(\n",
+        "    description=\"Load models — 1 request, 0 CU\", layout=widgets.Layout(width=\"300px\")\n",
+        ")\n",
+        "output = widgets.Output()\n",
+        "last_catalog = None\n",
+        "\n",
+        "\n",
+        "def load_models(_):\n",
+        "    global last_catalog\n",
+        "    last_catalog = None\n",
+        "    load_button.disabled = True\n",
+        "    with output:\n",
+        "        output.clear_output(wait=True)\n",
+        "        try:\n",
+        "            with MorphIQ() as client:\n",
+        "                last_catalog = client.pricing_models()\n",
+        "            for model in last_catalog.models:\n",
+        "                print(model.name, \"—\", model.id, \"—\", model.model_version)\n",
+        "                print(\"Single:\", \", \".join(model.operations))\n",
+        "                print(\"Batch:\", \", \".join(model.batch_operations) or \"none\")\n",
+        "                print(\"Aliases:\", model.aliases)\n",
+        "                print(\"Guidance:\", model.guidance)\n",
+        "                for constraint in model.constraints:\n",
+        "                    print(\"Constraint:\", constraint.model_dump(exclude_unset=True))\n",
+        "                print()\n",
+        "            print(\"Greek units:\", last_catalog.greek_units)\n",
+        "            print(\"Engines:\", [engine.model_dump() for engine in last_catalog.engines])\n",
+        "        except MorphIQError as error:\n",
+        "            print(error)\n",
+        "        finally:\n",
+        "            load_button.disabled = False\n",
+        "\n",
+        "\n",
+        "load_button.on_click(load_models)\n",
+        "display(load_button, output)"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}