Nightly spec-drift: strict contract tests failing (since 2026-09-01)

[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/33500030975

Failing test output (last 200 lines)

    
        schema = _resolve_request_body_schema(
            self.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,
        )
    
        # Issue #52: also drift-check nested BaseModel fields (one level deep).
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(
            model_cls,
            schema,
            self.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}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.api_keys.CreateApiKeyRequest <-> #/components/schemas/CreateApiKeyRequest
E           [ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']

tests/test_contracts.py:1718: Failed
________ TestRequestBodyDrift.test_body_properties_match_spec[generate] ________

self = <tests.test_contracts.TestRequestBodyDrift object at 0x7f452d242810>
entry = MethodEndpointEntry(sdk_method='kalshi.resources.api_keys.ApiKeysResource.generate', http_method='POST', path_template='/api_keys/generate', request_body_schema='#/components/schemas/GenerateApiKeyRequest')

    def test_body_properties_match_spec(
        self,
        entry: MethodEndpointEntry,
    ) -> None:
        assert entry.request_body_schema is not None
        model_fqn = BODY_MODEL_MAP.get(entry.request_body_schema)
        assert model_fqn is not None, (
            f"No request model registered in BODY_MODEL_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(
            self.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,
        )
    
        # Issue #52: also drift-check nested BaseModel fields (one level deep).
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(
            model_cls,
            schema,
            self.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}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.api_keys.GenerateApiKeyRequest <-> #/components/schemas/GenerateApiKeyRequest
E           [ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']

tests/test_contracts.py:1718: Failed
_ TestRequestBodyDrift.test_body_properties_match_spec[set_target_balance_allocation] _

self = <tests.test_contracts.TestRequestBodyDrift object at 0x7f452d243710>
entry = MethodEndpointEntry(sdk_method='kalshi.resources.portfolio.PortfolioResource.set_target_balance_allocation', http_meth...e='/portfolio/target_balance_allocation', request_body_schema='#/components/schemas/SetTargetBalanceAllocationRequest')

    def test_body_properties_match_spec(
        self,
        entry: MethodEndpointEntry,
    ) -> None:
        assert entry.request_body_schema is not None
        model_fqn = BODY_MODEL_MAP.get(entry.request_body_schema)
        assert model_fqn is not None, (
            f"No request model registered in BODY_MODEL_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(
            self.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,
        )
    
        # Issue #52: also drift-check nested BaseModel fields (one level deep).
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(
            model_cls,
            schema,
            self.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}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
E           [ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']

tests/test_contracts.py:1718: Failed
=============================== warnings summary ===============================
tests/test_contracts.py::TestSpecDrift::test_additive_drift[SetTargetBalanceAllocationRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.portfolio.SetTargetBalanceAllocationRequest: Spec field 'resting_margin_reservation' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[ApiKey]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.ApiKey: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

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}/calibrations
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):
  - DELETE /fcm/margin/api_keys/{api_key_id}
  - GET /fcm/margin/api_keys
  - POST /fcm/margin/api_keys
  - POST /fcm/margin/api_keys/generate
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[list1] - Failed: kalshi.resources.api_keys.ApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[list1] - Failed: kalshi.resources.api_keys.AsyncApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[create0] - Failed: kalshi.models.api_keys.CreateApiKeyRequest <-> #/components/schemas/CreateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[generate] - Failed: kalshi.models.api_keys.GenerateApiKeyRequest <-> #/components/schemas/GenerateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[set_target_balance_allocation] - Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
[ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']
============ 7 failed, 738 passed, 7 warnings in 282.20s (0:04:42) =============

[github-actions]

Failing set changed as of 2026-09-02 (run).

Latest failing output (last 200 lines)

                model_fqn=nested_fqn,
                spec_schema=nested_schema,
                errors=errors,
                context=f"{model_fqn}.{field_name}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.api_keys.GenerateApiKeyRequest <-> #/components/schemas/GenerateApiKeyRequest
E           [ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']

tests/test_contracts.py:1718: Failed
_ TestRequestBodyDrift.test_body_properties_match_spec[set_target_balance_allocation] _

self = <tests.test_contracts.TestRequestBodyDrift object at 0x7f8f2b30b620>
entry = MethodEndpointEntry(sdk_method='kalshi.resources.portfolio.PortfolioResource.set_target_balance_allocation', http_meth...e='/portfolio/target_balance_allocation', request_body_schema='#/components/schemas/SetTargetBalanceAllocationRequest')

    def test_body_properties_match_spec(
        self,
        entry: MethodEndpointEntry,
    ) -> None:
        assert entry.request_body_schema is not None
        model_fqn = BODY_MODEL_MAP.get(entry.request_body_schema)
        assert model_fqn is not None, (
            f"No request model registered in BODY_MODEL_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(
            self.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,
        )
    
        # Issue #52: also drift-check nested BaseModel fields (one level deep).
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(
            model_cls,
            schema,
            self.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}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
E           [ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']

tests/test_contracts.py:1718: Failed
_ TestPerpsScmRequestBodyDrift.test_body_properties_match_spec[estimate_maintenance_margin] _

self = <tests.test_contracts.TestPerpsScmRequestBodyDrift object at 0x7f8f2b3627b0>
entry = MethodEndpointEntry(sdk_method='kalshi.perps.klear.resources.margin.MarginResource.estimate_maintenance_margin', http_...gin/estimate_maintenance_margin', request_body_schema='#/components/schemas/EstimatePortfolioMaintenanceMarginRequest')

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

tests/test_contracts.py:2223: 
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 

entry = MethodEndpointEntry(sdk_method='kalshi.perps.klear.resources.margin.MarginResource.estimate_maintenance_margin', http_...gin/estimate_maintenance_margin', request_body_schema='#/components/schemas/EstimatePortfolioMaintenanceMarginRequest')
spec = {'openapi': '3.0.0', 'info': {'title': 'Kalshi Clearing Member API', 'version': '0.0.1', 'description': 'Klear API end...}, {'url': 'https://demo-api.kalshi.co/klear-api/v1', 'description': 'Demo'}], 'security': [{'kalshiBearer': []}], ...}
body_map = {'#/components/schemas/WithdrawSettlementBalanceRequest': 'kalshi.perps.klear.models.margin.WithdrawSettlementBalanceR...timatePortfolioMaintenanceMarginRequest': 'kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest'}

    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.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest <-> #/components/schemas/EstimatePortfolioMaintenanceMarginRequest
E           [ADD drift] spec has properties SDK model missing: ['clearing_type', 'date']

tests/test_contracts.py:2101: Failed
=============================== warnings summary ===============================
tests/test_contracts.py::TestSpecDrift::test_additive_drift[SetTargetBalanceAllocationRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.portfolio.SetTargetBalanceAllocationRequest: Spec field 'resting_margin_reservation' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[ApiKey]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.ApiKey: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

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::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest: Spec field 'date' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest: Spec field 'clearing_type' 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::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}/calibrations
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):
  - GET /margin/fee_tier_rates
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):
  - DELETE /fcm/margin/api_keys/{api_key_id}
  - GET /fcm/margin/api_keys
  - POST /fcm/margin/api_keys
  - POST /fcm/margin/api_keys/generate
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[list1] - Failed: kalshi.resources.api_keys.ApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[positions0] - Failed: kalshi.resources.historical.HistoricalResource.positions <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[positions_all0] - Failed: kalshi.resources.historical.HistoricalResource.positions_all <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions_all', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[list1] - Failed: kalshi.resources.api_keys.AsyncApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[positions0] - Failed: kalshi.resources.historical.AsyncHistoricalResource.positions <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[positions_all0] - Failed: kalshi.resources.historical.AsyncHistoricalResource.positions_all <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions_all', '...')])
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[create0] - Failed: kalshi.models.api_keys.CreateApiKeyRequest <-> #/components/schemas/CreateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[generate] - Failed: kalshi.models.api_keys.GenerateApiKeyRequest <-> #/components/schemas/GenerateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[set_target_balance_allocation] - Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
[ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']
FAILED tests/test_contracts.py::TestPerpsScmRequestBodyDrift::test_body_properties_match_spec[estimate_maintenance_margin] - Failed: kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest <-> #/components/schemas/EstimatePortfolioMaintenanceMarginRequest
[ADD drift] spec has properties SDK model missing: ['clearing_type', 'date']
============ 13 failed, 732 passed, 9 warnings in 296.48s (0:04:56) ============

[github-actions]

Failing set changed as of 2026-09-03 (run).

Latest failing output (last 200 lines)

            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,
        )
    
        # Issue #52: also drift-check nested BaseModel fields (one level deep).
        for field_name, nested_cls, nested_schema in _iter_nested_body_models(
            model_cls,
            schema,
            self.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}",
            )
    
        if errors:
>           pytest.fail(f"{model_fqn} <-> {entry.request_body_schema}\n" + "\n".join(errors))
E           Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
E           [ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']

tests/test_contracts.py:1718: Failed
_ TestPerpsScmRequestBodyDrift.test_body_properties_match_spec[estimate_maintenance_margin] _

self = <tests.test_contracts.TestPerpsScmRequestBodyDrift object at 0x7fe5759ea390>
entry = MethodEndpointEntry(sdk_method='kalshi.perps.klear.resources.margin.MarginResource.estimate_maintenance_margin', http_...gin/estimate_maintenance_margin', request_body_schema='#/components/schemas/EstimatePortfolioMaintenanceMarginRequest')

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

tests/test_contracts.py:2223: 
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 

entry = MethodEndpointEntry(sdk_method='kalshi.perps.klear.resources.margin.MarginResource.estimate_maintenance_margin', http_...gin/estimate_maintenance_margin', request_body_schema='#/components/schemas/EstimatePortfolioMaintenanceMarginRequest')
spec = {'openapi': '3.0.0', 'info': {'title': 'Kalshi Clearing Member API', 'version': '0.0.1', 'description': 'Klear API end...}, {'url': 'https://demo-api.kalshi.co/klear-api/v1', 'description': 'Demo'}], 'security': [{'kalshiBearer': []}], ...}
body_map = {'#/components/schemas/WithdrawSettlementBalanceRequest': 'kalshi.perps.klear.models.margin.WithdrawSettlementBalanceR...timatePortfolioMaintenanceMarginRequest': 'kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest'}

    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.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest <-> #/components/schemas/EstimatePortfolioMaintenanceMarginRequest
E           [ADD drift] spec has properties SDK model missing: ['clearing_type', 'date']

tests/test_contracts.py:2101: Failed
=============================== warnings summary ===============================
tests/test_contracts.py::TestSpecDrift::test_additive_drift[SetTargetBalanceAllocationRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.portfolio.SetTargetBalanceAllocationRequest: Spec field 'resting_margin_reservation' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[ApiKey]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.ApiKey: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[CreateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.CreateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyRequest: Spec field 'fcm_subtrader_id' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestSpecDrift::test_additive_drift[GenerateApiKeyResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:837: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.models.api_keys.GenerateApiKeyResponse: Spec field 'warning' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

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::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest: Spec field 'date' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginRequest]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest: Spec field 'clearing_type' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginResponse: Spec field 'base_margin_fp' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginResponse: Spec field 'hvar_fp' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginResponse: Spec field 'apc_fp' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginResponse: Spec field 'funding_addon_fp' has no SDK mapping
    _warn_additive_optional(entry.sdk_model, additive_optional)

tests/test_contracts.py::TestPerpsScmSpecDrift::test_response_drift[EstimatePortfolioMaintenanceMarginResponse]
  /home/runner/work/kalshi-python-sdk/kalshi-python-sdk/tests/test_contracts.py:2111: AdditiveOptionalDriftWarning: Additive-optional drift in kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginResponse: Spec field 'liquidation_addon_fp' 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::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}/calibrations
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):
  - GET /margin/fee_tier_rates
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):
  - DELETE /fcm/margin/api_keys/{api_key_id}
  - GET /fcm/margin/api_keys
  - POST /fcm/margin/api_keys
  - POST /fcm/margin/api_keys/generate
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[list1] - Failed: kalshi.resources.api_keys.ApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[positions0] - Failed: kalshi.resources.historical.HistoricalResource.positions <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[positions_all0] - Failed: kalshi.resources.historical.HistoricalResource.positions_all <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions_all', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[orders1] - Failed: kalshi.resources.fcm.FcmResource.orders <-> GET /fcm/orders
[ADD drift] spec has params SDK missing: ['client_order_ids']
(Allowlist via EXCLUSIONS[('kalshi.resources.fcm.FcmResource.orders', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_sync_params_match_spec[orders_all1] - Failed: kalshi.resources.fcm.FcmResource.orders_all <-> GET /fcm/orders
[ADD drift] spec has params SDK missing: ['client_order_ids']
(Allowlist via EXCLUSIONS[('kalshi.resources.fcm.FcmResource.orders_all', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[list1] - Failed: kalshi.resources.api_keys.AsyncApiKeysResource.list <-> GET /api_keys
[ADD drift] spec has params SDK missing: ['fcm_subtrader_id']
(Allowlist via EXCLUSIONS[('kalshi.resources.api_keys.ApiKeysResource.list', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[positions0] - Failed: kalshi.resources.historical.AsyncHistoricalResource.positions <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[positions_all0] - Failed: kalshi.resources.historical.AsyncHistoricalResource.positions_all <-> GET /historical/positions
[ADD drift] spec has params SDK missing: ['subaccount']
(Allowlist via EXCLUSIONS[('kalshi.resources.historical.HistoricalResource.positions_all', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[orders1] - Failed: kalshi.resources.fcm.AsyncFcmResource.orders <-> GET /fcm/orders
[ADD drift] spec has params SDK missing: ['client_order_ids']
(Allowlist via EXCLUSIONS[('kalshi.resources.fcm.FcmResource.orders', '...')])
FAILED tests/test_contracts.py::TestRequestParamDrift::test_async_params_match_spec[orders_all1] - Failed: kalshi.resources.fcm.AsyncFcmResource.orders_all <-> GET /fcm/orders
[ADD drift] spec has params SDK missing: ['client_order_ids']
(Allowlist via EXCLUSIONS[('kalshi.resources.fcm.FcmResource.orders_all', '...')])
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[create0] - Failed: kalshi.models.api_keys.CreateApiKeyRequest <-> #/components/schemas/CreateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[generate] - Failed: kalshi.models.api_keys.GenerateApiKeyRequest <-> #/components/schemas/GenerateApiKeyRequest
[ADD drift] spec has properties SDK model missing: ['fcm_subtrader_id']
FAILED tests/test_contracts.py::TestRequestBodyDrift::test_body_properties_match_spec[set_target_balance_allocation] - Failed: kalshi.models.portfolio.SetTargetBalanceAllocationRequest <-> #/components/schemas/SetTargetBalanceAllocationRequest
[ADD drift] spec has properties SDK model missing: ['resting_margin_reservation']
FAILED tests/test_contracts.py::TestPerpsScmRequestBodyDrift::test_body_properties_match_spec[estimate_maintenance_margin] - Failed: kalshi.perps.klear.models.margin.EstimatePortfolioMaintenanceMarginRequest <-> #/components/schemas/EstimatePortfolioMaintenanceMarginRequest
[ADD drift] spec has properties SDK model missing: ['clearing_type', 'date']
=========== 17 failed, 728 passed, 14 warnings in 288.27s (0:04:48) ============