add crypto docs, better error handling

Author: Graeme22

docs/orders.rst

@@ -131,7 +131,7 @@ Note that to cancel complex orders, you need to use the ``delete_complex_order``
 Notional market orders
 ----------------------
 
-Notional orders are slightly different from normal orders. Since the market will determine both the quantity and the price for you, you need to pass `value` instead of price, and pass `None` for the `quantity` parameter to ``build_leg``.
+Notional orders are slightly different from normal orders. Since the market will determine both the quantity and the price for you, you need to pass ``value`` instead of price, and pass ``None`` for the ``quantity`` parameter to ``build_leg``.
 
 .. code-block:: python
 
@@ -145,3 +145,23 @@ Notional orders are slightly different from normal orders. Since the market will
         ]
     )
     resp = account.place_order(session, order, dry_run=False)
+
+Cryptocurrency orders
+---------------------
+
+Cryptocurrency orders should use the special ``IOC`` TIF:
+
+.. code-block:: python
+
+    order = NewOrder(
+        time_in_force=OrderTimeInForce.IOC,
+        order_type=OrderType.NOTIONAL_MARKET,
+        value=-Decimal(100),  # buy $100 of ETH
+        legs=[
+            Leg(
+                instrument_type=InstrumentType.CRYPTOCURRENCY,
+                action=OrderAction.BUY_TO_OPEN,
+                symbol="ETH/USD",
+            ),
+        ],
+    )

tastytrade/__init__.py

@@ -4,7 +4,7 @@
 BACKTEST_URL = "https://backtester.vast.tastyworks.com"
 CERT_URL = "https://api.cert.tastyworks.com"
 VAST_URL = "https://vast.tastyworks.com"
-VERSION = "10.3.0"
+VERSION = "10.3.1"
 
 __version__ = VERSION
 version_str: str = f"tastyware/tastytrade:v{VERSION}"

tastytrade/utils.py

@@ -9,6 +9,8 @@
 from pandas_market_calendars import get_calendar  # type: ignore[import-untyped]
 from pydantic import BaseModel, ConfigDict
 
+from tastytrade import logger
+
 NYSE: Any = get_calendar("NYSE")
 TZ = ZoneInfo("US/Eastern")
 
@@ -259,10 +261,12 @@ def validate_response(response: Response) -> None:
         errors = content.get("errors") or [content]
         message = ""
         for error in errors:
-            if "code" in error:
+            if "code" in error and "message" in error:
                 message += f"{error['code']}: {error['message']}\n"
-            else:
+            elif "domain" in error and "reason" in error:
                 message += f"{error['domain']}: {error['reason']}\n"
+            else:
+                logger.debug(f"Unknown error type: {error}")
 
         raise TastytradeError(message)