Nightly spec-drift: strict contract tests failing (since 2026-08-18)

[github-actions]

Nightly strict contract tests failed

The scheduled Spec Drift Detection run found the SDK contract suite no longer matches upstream OpenAPI/AsyncAPI.

To resolve: locally run uv run python scripts/sync_spec.py + uv run python scripts/generate.py, reconcile models/maps, and open a PR with Closes #<this issue>. This tracker auto-closes on the next green scheduled run.

To silence while a reconcile is in flight, add the spec-drift-ack label — nightly runs then stop commenting until the failing set changes.

• Failing run: https://github.com/TexasCoding/kalshi-python-sdk/actions/runs/32107397278

Failing test output (last 200 lines)

tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[CreateOrderGroupResponse] PASSED [ 87%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginPosition] PASSED [ 87%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginPositionsResponse] PASSED [ 87%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginFill] PASSED [ 87%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginTrade] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginSubaccountBalance] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginBalanceResponse] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginRiskPosition] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginRiskResponse] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[NotionalRiskLimitResponse] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginFeeTiersResponse] PASSED [ 88%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[AccountApiLimits] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginFundingRate] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginFundingHistoryEntry] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[MarginFundingRateEstimate] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginHistoricalFundingRatesResponse] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetMarginFundingHistoryResponse] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[IntraExchangeInstanceTransferResponse] PASSED [ 89%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[CreateSubaccountResponse] PASSED [ 90%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[CreateMarginFCMSubtraderRequest] PASSED [ 90%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[CreateMarginFCMSubtraderResponse] PASSED [ 90%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[FCMSubtraderRiskControls] PASSED [ 90%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[GetFCMSubtraderRiskControlsResponse] PASSED [ 90%]
tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[UpdateFCMSubtraderRiskControlsRequest] PASSED [ 90%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[margin_reports] PASSED [ 90%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[active_obligations] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[obligation_history] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[obligation_history_all] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_details] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_details_all] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[maintenance_margin_details] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[maintenance_margin_details_all] PASSED [ 91%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[funding_payments] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[funding_payments_all] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_estimate_by_asset_class] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_balance] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[guaranty_fund_balance] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_balance_history] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_balance_history_all] PASSED [ 92%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[settlement_balance_withdrawal] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[list_subtrader_groups] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_sync_params_match_spec[delete_subtrader_group] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[margin_reports] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[active_obligations] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[obligation_history] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[obligation_history_all] PASSED [ 93%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_details] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_details_all] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[maintenance_margin_details] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[maintenance_margin_details_all] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[funding_payments] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[funding_payments_all] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_estimate_by_asset_class] PASSED [ 94%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_balance] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[guaranty_fund_balance] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_balance_history] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_balance_history_all] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[settlement_balance_withdrawal] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[list_subtrader_groups] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestParamDrift::test_async_params_match_spec[delete_subtrader_group] PASSED [ 95%]
tests/test_contracts.py::TestPerpsScmRequestBodyDrift::test_body_properties_match_spec[withdraw_settlement_balance] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmRequestBodyDrift::test_body_properties_match_spec[create_subtrader_group] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmRequestBodyDrift::test_body_properties_match_spec[update_subtrader_group] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[MarginReport] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetMarginReportsResponse] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[ObligationReceiveInfo] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[SettlementDetail] PASSED [ 96%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[MaintenanceMarginDetail] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[FundingPaymentDetail] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[ObligationEntry] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetActiveMarginObligationsResponse] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetObligationSettlementDetailsResponse] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetObligationMaintenanceMarginDetailsResponse] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetObligationFundingPaymentsResponse] PASSED [ 97%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[MarketSettlementEstimate] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[SettlementEstimate] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[AssetClassSettlementEstimate] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetSettlementEstimateByAssetClassResponse] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetSettlementBalanceResponse] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetGuarantyFundBalanceResponse] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[WithdrawSettlementBalanceResponse] PASSED [ 98%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetSettlementBalanceWithdrawalResponse] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[SettlementBalanceHistoryEntry] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[MarginSubtraderGroup] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[GetMarginSubtraderGroupsResponse] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[CreateMarginSubtraderGroupRequest] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[CreateMarginSubtraderGroupResponse] PASSED [ 99%]
tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[UpdateMarginSubtraderGroupRequest] PASSED [100%]

=================================== FAILURES ===================================
___________________ test_every_spec_endpoint_is_mapped[core] ___________________

spec_loader = <function _load_spec at 0x7f4f07b931a0>
endpoint_map = [MethodEndpointEntry(sdk_method='kalshi.resources.markets.MarketsResource.list', http_method='GET', path_template='/ma...rkets.MarketsResource.list_trades', http_method='GET', path_template='/markets/trades', request_body_schema=None), ...]
label = 'core'

    @pytest.mark.parametrize(
        ("spec_loader", "endpoint_map", "label"),
        [
            (_load_spec, METHOD_ENDPOINT_MAP, "core"),
            (_load_perps_spec, PERPS_METHOD_ENDPOINT_MAP, "perps"),
            (_load_perps_scm_spec, PERPS_SCM_METHOD_ENDPOINT_MAP, "perps_scm"),
        ],
        ids=["core", "perps", "perps_scm"],
    )
    def test_every_spec_endpoint_is_mapped(
        spec_loader: Any,
        endpoint_map: list[MethodEndpointEntry],
        label: str,
    ) -> None:
        """Fail if a spec operation is neither mapped nor explicitly unimplemented.
    
        Closes the false-negative gap where a newly-ADDED upstream endpoint shipped
        untested because nothing asserted spec paths ⊆ ``METHOD_ENDPOINT_MAP``. The
        reverse direction (a map entry whose path the spec dropped) is caught by the
        param-drift tests, which fail loud when the path is absent from the spec.
        """
        spec_ops = _spec_operations(spec_loader())
        mapped = {(e.http_method.upper(), e.path_template) for e in endpoint_map}
        unmapped = spec_ops - mapped - set(_UNIMPLEMENTED_ENDPOINTS)
        if unmapped:
>           pytest.fail(
                f"{label}: spec operations not in the endpoint map (add a "
                f"MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):\n"
                + "\n".join(f"  - {m} {p}" for m, p in sorted(unmapped))
            )
E           Failed: core: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
E             - GET /live_data/weather/{city}
E             - GET /portfolio/target_balance_allocation
E             - POST /portfolio/target_balance_allocation

tests/test_contracts.py:1299: Failed
__________________ test_every_spec_endpoint_is_mapped[perps] ___________________

spec_loader = <function _load_perps_spec at 0x7f4f077760c0>
endpoint_map = [MethodEndpointEntry(sdk_method='kalshi.perps.resources.exchange.PerpsExchangeResource.status', http_method='GET', pat...urce.orderbook', http_method='GET', path_template='/margin/markets/{ticker}/orderbook', request_body_schema=None), ...]
label = 'perps'

    @pytest.mark.parametrize(
        ("spec_loader", "endpoint_map", "label"),
        [
            (_load_spec, METHOD_ENDPOINT_MAP, "core"),
            (_load_perps_spec, PERPS_METHOD_ENDPOINT_MAP, "perps"),
            (_load_perps_scm_spec, PERPS_SCM_METHOD_ENDPOINT_MAP, "perps_scm"),
        ],
        ids=["core", "perps", "perps_scm"],
    )
    def test_every_spec_endpoint_is_mapped(
        spec_loader: Any,
        endpoint_map: list[MethodEndpointEntry],
        label: str,
    ) -> None:
        """Fail if a spec operation is neither mapped nor explicitly unimplemented.
    
        Closes the false-negative gap where a newly-ADDED upstream endpoint shipped
        untested because nothing asserted spec paths ⊆ ``METHOD_ENDPOINT_MAP``. The
        reverse direction (a map entry whose path the spec dropped) is caught by the
        param-drift tests, which fail loud when the path is absent from the spec.
        """
        spec_ops = _spec_operations(spec_loader())
        mapped = {(e.http_method.upper(), e.path_template) for e in endpoint_map}
        unmapped = spec_ops - mapped - set(_UNIMPLEMENTED_ENDPOINTS)
        if unmapped:
>           pytest.fail(
                f"{label}: spec operations not in the endpoint map (add a "
                f"MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):\n"
                + "\n".join(f"  - {m} {p}" for m, p in sorted(unmapped))
            )
E           Failed: perps: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
E             - DELETE /margin/cross/positions/{ticker}/exit_trigger
E             - DELETE /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
E             - DELETE /margin/isolated/positions/{ticker}/exit_trigger
E             - GET /margin/cross/positions/{ticker}/exit_trigger
E             - GET /margin/isolated/positions/{ticker}/exit_trigger
E             - PUT /margin/cross/positions/{ticker}/exit_trigger
E             - PUT /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
E             - PUT /margin/isolated/positions/{ticker}/exit_trigger

tests/test_contracts.py:1299: Failed
=============================== warnings summary ===============================
tests/test_contracts.py::TestAdditiveDriftClassification::test_optional_drift_survives_the_nightly_strict_gate
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:988: AdditiveOptionalDriftWarning: Additive-optional drift in tests.synthetic.Fake: Spec field 'opt_new' has no SDK mapping
    _warn_additive_optional("tests.synthetic.Fake", msgs)

-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
=========================== short test summary info ============================
FAILED tests/test_contracts.py::test_every_spec_endpoint_is_mapped[core] - Failed: core: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
  - GET /live_data/weather/{city}
  - GET /portfolio/target_balance_allocation
  - POST /portfolio/target_balance_allocation
FAILED tests/test_contracts.py::test_every_spec_endpoint_is_mapped[perps] - Failed: perps: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
  - DELETE /margin/cross/positions/{ticker}/exit_trigger
  - DELETE /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
  - DELETE /margin/isolated/positions/{ticker}/exit_trigger
  - GET /margin/cross/positions/{ticker}/exit_trigger
  - GET /margin/isolated/positions/{ticker}/exit_trigger
  - PUT /margin/cross/positions/{ticker}/exit_trigger
  - PUT /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
  - PUT /margin/isolated/positions/{ticker}/exit_trigger
============= 2 failed, 695 passed, 1 warning in 270.42s (0:04:30) =============

[github-actions]

Failing set changed as of 2026-08-19 (run).

Latest failing output (last 200 lines)

    
        sdk_params = _signature_params(sdk_fqn)
        sdk_params.discard("extra_headers")
        spec_params_list = _resolve_path_params(spec, entry.path_template, entry.http_method)
        spec_params = {p["name"] for p in spec_params_list if p.get("in") in ("query", "path")}
        spec_params |= _path_params_from_template(entry.path_template)
    
        lookup_fqn = entry.sdk_method
        missing = spec_params - sdk_params
        missing_unallowed = {p for p in missing if (lookup_fqn, p) not in PERPS_EXCLUSIONS}
        extra = sdk_params - spec_params
        extra_unallowed = {p for p in extra if (lookup_fqn, p) not in PERPS_EXCLUSIONS}
    
        errors: list[str] = []
        if missing_unallowed:
            errors.append(f"[ADD drift] spec has params SDK missing: {sorted(missing_unallowed)}")
        if extra_unallowed:
            errors.append(f"[REMOVE drift] SDK has params spec doesn't: {sorted(extra_unallowed)}")
        if errors:
>           pytest.fail(
                f"{sdk_fqn} <-> {entry.http_method} {entry.path_template}\n"
                + "\n".join(errors)
                + f"\n(Allowlist via PERPS_EXCLUSIONS[({lookup_fqn!r}, '...')])"
            )
E           Failed: kalshi.perps.resources.fcm.AsyncFcmResource.risk_controls <-> GET /margin/fcm/subtraders/risk_controls
E           [ADD drift] spec has params SDK missing: ['asset_class']
E           (Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.risk_controls', '...')])

tests/test_contracts.py:2043: Failed
_ TestPerpsRequestParamDrift.test_async_params_match_spec[delete_risk_controls] _

self = <tests.test_contracts.TestPerpsRequestParamDrift object at 0x7f68c4367170>
entry = MethodEndpointEntry(sdk_method='kalshi.perps.resources.fcm.FcmResource.delete_risk_controls', http_method='DELETE', path_template='/margin/fcm/subtraders/risk_controls', request_body_schema=None)

    def test_async_params_match_spec(self, entry: MethodEndpointEntry | None) -> None:
        if entry is None:
            pytest.skip("no perps REST GET/DELETE endpoints registered yet")
>       _assert_perps_params_match(entry, self.spec, async_=True)

tests/test_contracts.py:2139: 
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 

entry = MethodEndpointEntry(sdk_method='kalshi.perps.resources.fcm.FcmResource.delete_risk_controls', http_method='DELETE', path_template='/margin/fcm/subtraders/risk_controls', request_body_schema=None)
spec = {'openapi': '3.0.0', 'info': {'title': 'Kalshi Trade API Manual Endpoints', 'version': '0.0.1', 'description': 'Manual...nge Status', 'description': 'Endpoint for getting the margin exchange status.', 'tags': ['exchange'], ...}}, ...}, ...}
async_ = True

    def _assert_perps_params_match(
        entry: MethodEndpointEntry,
        spec: dict[str, Any],
        *,
        async_: bool,
    ) -> None:
        """Param-drift assertion for one perps GET/DELETE entry (mirrors the core check)."""
        sdk_fqn = entry.sdk_method
        if async_:
            parts = sdk_fqn.split(".")
            parts[-2] = f"Async{parts[-2]}"
            sdk_fqn = ".".join(parts)
            module_name = ".".join(parts[:-2])
            cls_name = parts[-2]
            module = importlib.import_module(module_name)
            assert hasattr(module, cls_name), f"Missing async sibling {cls_name} in {module_name}"
    
        sdk_params = _signature_params(sdk_fqn)
        sdk_params.discard("extra_headers")
        spec_params_list = _resolve_path_params(spec, entry.path_template, entry.http_method)
        spec_params = {p["name"] for p in spec_params_list if p.get("in") in ("query", "path")}
        spec_params |= _path_params_from_template(entry.path_template)
    
        lookup_fqn = entry.sdk_method
        missing = spec_params - sdk_params
        missing_unallowed = {p for p in missing if (lookup_fqn, p) not in PERPS_EXCLUSIONS}
        extra = sdk_params - spec_params
        extra_unallowed = {p for p in extra if (lookup_fqn, p) not in PERPS_EXCLUSIONS}
    
        errors: list[str] = []
        if missing_unallowed:
            errors.append(f"[ADD drift] spec has params SDK missing: {sorted(missing_unallowed)}")
        if extra_unallowed:
            errors.append(f"[REMOVE drift] SDK has params spec doesn't: {sorted(extra_unallowed)}")
        if errors:
>           pytest.fail(
                f"{sdk_fqn} <-> {entry.http_method} {entry.path_template}\n"
                + "\n".join(errors)
                + f"\n(Allowlist via PERPS_EXCLUSIONS[({lookup_fqn!r}, '...')])"
            )
E           Failed: kalshi.perps.resources.fcm.AsyncFcmResource.delete_risk_controls <-> DELETE /margin/fcm/subtraders/risk_controls
E           [ADD drift] spec has params SDK missing: ['asset_class']
E           (Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.delete_risk_controls', '...')])

tests/test_contracts.py:2043: Failed
_ TestPerpsRequestBodyDrift.test_body_properties_match_spec[update_risk_controls] _

self = <tests.test_contracts.TestPerpsRequestBodyDrift object at 0x7f68c4367e60>
entry = MethodEndpointEntry(sdk_method='kalshi.perps.resources.fcm.FcmResource.update_risk_controls', http_method='PUT', path_...margin/fcm/subtraders/risk_controls', request_body_schema='#/components/schemas/UpdateFCMSubtraderRiskControlsRequest')

    def test_body_properties_match_spec(self, entry: MethodEndpointEntry | None) -> None:
        if entry is None:
            pytest.skip("no perps REST body endpoints registered yet")
>       _assert_perps_body_match(entry, self.spec, PERPS_BODY_MODEL_MAP)

tests/test_contracts.py:2155: 
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 

entry = MethodEndpointEntry(sdk_method='kalshi.perps.resources.fcm.FcmResource.update_risk_controls', http_method='PUT', path_...margin/fcm/subtraders/risk_controls', request_body_schema='#/components/schemas/UpdateFCMSubtraderRiskControlsRequest')
spec = {'openapi': '3.0.0', 'info': {'title': 'Kalshi Trade API Manual Endpoints', 'version': '0.0.1', 'description': 'Manual...nge Status', 'description': 'Endpoint for getting the margin exchange status.', 'tags': ['exchange'], ...}}, ...}, ...}
body_map = {'#/components/schemas/CreateMarginOrderRequest': 'kalshi.perps.models.orders.CreateMarginOrderRequest', '#/components...uest', '#/components/schemas/CreateOrderGroupRequest': 'kalshi.perps.models.order_groups.CreateOrderGroupRequest', ...}

    def _assert_perps_body_match(
        entry: MethodEndpointEntry,
        spec: dict[str, Any],
        body_map: dict[str, str],
    ) -> None:
        """Body-drift assertion for one perps body entry (mirrors the core check)."""
        assert entry.request_body_schema is not None
        model_fqn = body_map.get(entry.request_body_schema)
        assert model_fqn is not None, (
            f"No request model registered in the perps body map for "
            f"{entry.request_body_schema!r}. Add the mapping."
        )
        model_cls = _get_model_class_from_fqn(model_fqn)
        schema = _resolve_request_body_schema(spec, entry.path_template, entry.http_method)
        assert schema is not None, (
            f"Spec has no body schema for {entry.http_method} {entry.path_template}"
        )
        errors: list[str] = []
        _check_model_drift(
            model_cls=model_cls,
            model_fqn=model_fqn,
            spec_schema=schema,
            errors=errors,
            exclusions=PERPS_EXCLUSIONS,
        )
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(model_cls, schema, spec):
            nested_fqn = f"{nested_cls.__module__}.{nested_cls.__qualname__}"
            _check_model_drift(
                model_cls=nested_cls,
                model_fqn=nested_fqn,
                spec_schema=nested_schema,
                errors=errors,
                context=f"{model_fqn}.{field_name}",
                exclusions=PERPS_EXCLUSIONS,
            )
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.perps.models.fcm.UpdateFCMSubtraderRiskControlsRequest <-> #/components/schemas/UpdateFCMSubtraderRiskControlsRequest
E           [ADD drift] spec has properties SDK model missing: ['asset_class']

tests/test_contracts.py:2086: Failed
=============================== warnings summary ===============================
tests/test_contracts.py::TestAdditiveDriftClassification::test_optional_drift_survives_the_nightly_strict_gate
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:988: AdditiveOptionalDriftWarning: Additive-optional drift in tests.synthetic.Fake: Spec field 'opt_new' has no SDK mapping
    _warn_additive_optional("tests.synthetic.Fake", msgs)

tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[FCMSubtraderRiskControls]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2096: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.models.fcm.FCMSubtraderRiskControls: Spec field 'asset_class' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsSpecDrift::test_response_drift[UpdateFCMSubtraderRiskControlsRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2096: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.models.fcm.UpdateFCMSubtraderRiskControlsRequest: Spec field 'asset_class' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
=========================== short test summary info ============================
FAILED tests/test_contracts.py::TestSpecDrift::test_additive_drift[Fill] - Failed: Additive drift (new required fields) in kalshi.models.orders.Fill:
  - Spec field 'exchange_index' has no SDK mapping
FAILED tests/test_contracts.py::TestSpecDrift::test_additive_drift[MarketPosition] - Failed: Additive drift (new required fields) in kalshi.models.portfolio.MarketPosition:
  - Spec field 'exchange_index' has no SDK mapping
FAILED tests/test_contracts.py::TestSpecDrift::test_additive_drift[Settlement] - Failed: Additive drift (new required fields) in kalshi.models.portfolio.Settlement:
  - Spec field 'exchange_index' has no SDK mapping
FAILED tests/test_contracts.py::test_every_spec_endpoint_is_mapped[core] - Failed: core: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
  - GET /live_data/weather/{city}
  - GET /portfolio/target_balance_allocation
  - POST /portfolio/target_balance_allocation
FAILED tests/test_contracts.py::test_every_spec_endpoint_is_mapped[perps] - Failed: perps: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
  - DELETE /margin/cross/positions/{ticker}/exit_trigger
  - DELETE /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
  - DELETE /margin/isolated/positions/{ticker}/exit_trigger
  - GET /margin/cross/positions/{ticker}/exit_trigger
  - GET /margin/isolated/positions/{ticker}/exit_trigger
  - PUT /margin/cross/positions/{ticker}/exit_trigger
  - PUT /margin/cross/positions/{ticker}/exit_trigger/{trigger_id}
  - PUT /margin/isolated/positions/{ticker}/exit_trigger
FAILED tests/test_contracts.py::test_every_spec_endpoint_is_mapped[perps_scm] - Failed: perps_scm: spec operations not in the endpoint map (add a MethodEndpointEntry, or record in _UNIMPLEMENTED_ENDPOINTS with a reason):
  - GET /margin/settlement_prices
FAILED tests/test_contracts.py::TestPerpsRequestParamDrift::test_sync_params_match_spec[risk_controls] - Failed: kalshi.perps.resources.fcm.FcmResource.risk_controls <-> GET /margin/fcm/subtraders/risk_controls
[ADD drift] spec has params SDK missing: ['asset_class']
(Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.risk_controls', '...')])
FAILED tests/test_contracts.py::TestPerpsRequestParamDrift::test_sync_params_match_spec[delete_risk_controls] - Failed: kalshi.perps.resources.fcm.FcmResource.delete_risk_controls <-> DELETE /margin/fcm/subtraders/risk_controls
[ADD drift] spec has params SDK missing: ['asset_class']
(Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.delete_risk_controls', '...')])
FAILED tests/test_contracts.py::TestPerpsRequestParamDrift::test_async_params_match_spec[risk_controls] - Failed: kalshi.perps.resources.fcm.AsyncFcmResource.risk_controls <-> GET /margin/fcm/subtraders/risk_controls
[ADD drift] spec has params SDK missing: ['asset_class']
(Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.risk_controls', '...')])
FAILED tests/test_contracts.py::TestPerpsRequestParamDrift::test_async_params_match_spec[delete_risk_controls] - Failed: kalshi.perps.resources.fcm.AsyncFcmResource.delete_risk_controls <-> DELETE /margin/fcm/subtraders/risk_controls
[ADD drift] spec has params SDK missing: ['asset_class']
(Allowlist via PERPS_EXCLUSIONS[('kalshi.perps.resources.fcm.FcmResource.delete_risk_controls', '...')])
FAILED tests/test_contracts.py::TestPerpsRequestBodyDrift::test_body_properties_match_spec[update_risk_controls] - Failed: kalshi.perps.models.fcm.UpdateFCMSubtraderRiskControlsRequest <-> #/components/schemas/UpdateFCMSubtraderRiskControlsRequest
[ADD drift] spec has properties SDK model missing: ['asset_class']
============ 11 failed, 686 passed, 3 warnings in 268.23s (0:04:28) ============