Market Settlement

See Market Settlement for an overview. Settlement reports are available on KalshiPT sessions by default, unless ReceiveSettlementReports=N (tag 20127) is set during Logon, and on KalshiNR and KalshiRT sessions with ReceiveSettlementReports=Y.

Market Settlement Report (35=UMS)

Provides settlement details for a specific market.

Message Structure

Tag	Name	Description	Required
20105	MarketSettlementReportID	Unique settlement identifier	Yes
55	Symbol	Market ticker (e.g., NHIGH-23JAN02-66)	Yes
715	ClearingBusinessDate	Date settlement cleared (YYYYMMDD)	Yes
20106	TotNumMarketSettlementReports	Total number of settlement reports in sequence	No
20107	MarketResult	Result of the market when determined: `yes`, `no`, or `scalar`	Yes
893	LastFragment	Last page indicator (Y/N)	No
730	SettlementPrice	Pre-fee YES settlement price in cents (2 decimal places, e.g. `30.60`)	Yes

Repeating Groups

Collateral changes and fees are nested inside each NoMarketSettlementPartyIDs entry.

Party Information (NoMarketSettlementPartyIDs)

Tag	Name	Description
20108	NoMarketSettlementPartyIDs	Number of parties
20109	MarketSettlementPartyID	Unique identifier for party
20110	MarketSettlementPartyRole	Type of party (Customer Account<24>)
704	LongQty	Decimal quantity of YES position held
705	ShortQty	Decimal quantity of NO position held

Collateral Changes (NoCollateralAmountChanges)

Tag	Name	Description
1703	NoCollateralAmountChanges	Number of collateral changes (should be only 1 - payout balance change)
1704	CollateralAmountChange	For `PAYOUT`, the position’s settlement payout in dollars after deducting its settlement fee
1705	CollateralAmountType	`BALANCE` or `PAYOUT`

Fees (NoMiscFees)

Tag	Name	Description
136	NoMiscFees	Number of fee entries (always 1)
137	MiscFeeAmt	Total settlement fee for this party in dollars, already deducted from `PAYOUT` (zero when no fee)
138	MiscFeeCurr	Currency (USD)
139	MiscFeeType	Type of fee (Exchange fees<4>)
891	MiscFeeBasis	Unit for fee (Absolute<0>)

Example Settlement Report

// Market settled as "yes", no fees
8=FIXT.1.1|35=UMS|
20105=settle-123|55=HIGHNY-23DEC31|715=20231231|
20107=yes|730=100.00|
20108=1|
  20109=user-456|20110=24|
  704=100|705=0|
  1703=1|
    1704=100.00|1705=PAYOUT|
  136=1|
    137=0.00|138=USD|139=4|891=0|
893=Y|

// Direct user: scalar settlement with a sub-centicent rounding fee
8=FIXT.1.1|35=UMS|
20105=settle-456|55=HIGHNY-23DEC31|715=20231231|
20107=scalar|730=30.60|
20108=1|
  20109=user-789|20110=24|
  704=100.01|705=0|
  1703=1|
    1704=30.6030|1705=PAYOUT|
  136=1|
    137=0.00006|138=USD|139=4|891=0|
893=Y|

The first example shows:

Market HIGHNY-23DEC31 settled as “yes”
User held 100 Yes contracts
Received $100.00 payout to balance
Zero settlement fees

The second example is an independent scalar-settlement scenario for a direct user, with no collateral netting or settlement advances:

The user holds 100.01 YES contracts settling at 30.60 cents each.
Gross payout is 100.01 × $0.3060 = $30.60306.
With a starting available balance of $10.0000, settlement brings the balance to$ 40.60306 before rounding. At settlement, this direct-user subaccount’s available balance is rounded down to $0.0001 precision, giving a$ 40.6030 ending balance and a $0.00006 settlement fee.
Net payout (1704) is $30.60306 − $0.00006 = $30.6030.

The fee reduces the payout, not the settlement price in tag 730. Recover the pre-fee payout by adding MiscFeeAmt to the PAYOUT amount; do not deduct the fee again. Rounding applies to the resulting available balance, not independently to each payout.

Pagination

Large settlement batches may span multiple messages:

Tag	Use Case
20106	Total number of reports in batch
893	LastFragment=N for more pages, Y for last

Important: The MarketSettlementReportID (tag 20105) will be different across paginated responses. Each page of results generates a new unique settlement ID. Use the Symbol (tag 55) ticker to identify fragments belonging to the same paginated settlement.

REST

WebSockets

FIX