Fields in the record

Kalshi's settlement API identifies the market and event, outcome, Yes and No quantities, cost basis and settlement time. The revenue field is expressed in cents. Costs and fee_cost use fixed-point dollars. Kalshi · Get Settlements ↗

A straightforward example

A revenue value of 500 means a $5 payout. Subtract a separate $3 cost basis and a $0.20 fee to get $1.80. Check whether the fee is already reflected in another source. If part of the position was closed earlier, keep those cash flows as distinct records.

What to retain

Store the raw values, units and timestamp. Join the market ticker to the account or report identifier. Check contract-specific payout rules for scalar markets. A period's total result also needs trade and fee history beyond the final settlement row.