Skip to content

Reconcile OpenAPI/AsyncAPI/perps/SCM spec drift (v11.0.0) - #500

Merged
TexasCoding merged 1 commit into
mainfrom
fix/spec-drift-499
Aug 9, 2026
Merged

Reconcile OpenAPI/AsyncAPI/perps/SCM spec drift (v11.0.0)#500
TexasCoding merged 1 commit into
mainfrom
fix/spec-drift-499

Conversation

@TexasCoding

Copy link
Copy Markdown
Owner

Summary

Closes #499. Syncs upstream OpenAPI 3.27.0 content, AsyncAPI, perps OpenAPI, and perps SCM OpenAPI after nightly contract drift (including the later SCM obligation reshape).

Breaking

  • Removed Klear active_obligation() + GetActiveMarginObligationResponse (use active_obligations())
  • Removed Klear settlement_estimate() + GetSettlementEstimateResponse (use settlement_estimate_by_asset_class())
  • Required response fields: SettlementDetail.position_quantity_fp, ObligationEntry.funding_payments, ExchangeIndexStatus.description, MarginMarket.exchange_index, TradePayload.is_block_trade

Additive

  • Klear paged obligation detail endpoints: settlement_details / maintenance_margin_details / funding_payments (+ *_all)
  • Models: FundingPaymentDetail + paged response wrappers
  • ObligationEntry.*_truncated flags when inline arrays hit the 1000-row cap

Release prep

  • Version 11.0.0, CHANGELOG / migration / ROADMAP / docs updated

Test plan

  • uv run mypy kalshi/
  • uv run ruff check kalshi/ tests/
  • uv run pytest tests/ --ignore=tests/integration (4197 passed)
  • uv run --group docs mkdocs build --strict
  • CI green on this PR

Closes #499. Sync upstream specs and align models/maps after nightly
contract failures.

Breaking: remove Klear active_obligation() and settlement_estimate() after
upstream deleted the singular endpoints. Prefer active_obligations() and
settlement_estimate_by_asset_class().

Additive: Klear paged obligation detail endpoints, ExchangeIndexStatus.description,
MarginMarket.exchange_index, TradePayload.is_block_trade; required position/
funding fields on SettlementDetail and ObligationEntry.

Release prep for 11.0.0 (CHANGELOG, migration, ROADMAP, docs accuracy).
@TexasCoding
TexasCoding merged commit 8947341 into main Aug 9, 2026
6 checks passed
@TexasCoding
TexasCoding deleted the fix/spec-drift-499 branch August 9, 2026 14:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

1 participant