---
title: "Get Settlements"
method: GET
path: "/portfolio/settlements"
tags: ["portfolio"]
---

# Get Settlements

`GET /portfolio/settlements`

Endpoint for getting the member's settlements historical track.

## Query parameters

- `limit` integer
- `cursor` string
- `ticker` string
- `event_ticker` string
- `min_ts` integer
- `max_ts` integer
- `subaccount` integer

## Response `200`

Settlements retrieved successfully

- GetSettlementsResponse
  - `settlements` Settlement[], required
    - `ticker` string, required — The ticker symbol of the market that was settled.
    - `event_ticker` string, required — The event ticker symbol of the market that was settled.
    - `market_result` 'yes' | 'no' | 'scalar', required — The outcome of the market settlement. 'yes' = market resolved to YES, 'no' = market resolved to NO, 'scalar' = scalar market settled at a specific value.
    - `yes_count_fp` string, required — Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `yes_total_cost_dollars` string, required — US dollar amount as a fixed-point decimal string with up to 6 decimal places of precision. This is the maximum supported precision; valid quote intervals for a given market are constrained by that market's price level structure.
    - `no_count_fp` string, required — Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0-2 decimal places (e.g., "10", "10.0", "10.00"); responses always emit 2 decimals. Fractional contract values (e.g., "2.50") are supported; the minimum granularity is 0.01 contracts.
    - `no_total_cost_dollars` string, required — US dollar amount as a fixed-point decimal string with up to 6 decimal places of precision. This is the maximum supported precision; valid quote intervals for a given market are constrained by that market's price level structure.
    - `revenue` integer, required — Total revenue earned from this settlement in cents (winning contracts pay out 100 cents each).
    - `settled_time` string, date-time, required — Timestamp when the market was settled and payouts were processed.
    - `fee_cost` string, required — US dollar amount as a fixed-point decimal string with up to 6 decimal places of precision. This is the maximum supported precision; valid quote intervals for a given market are constrained by that market's price level structure.
    - `value` integer, nullable — Payout of a single yes contract in cents.
  - `cursor` string

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - authentication required
- `500` — Internal server error

---

[API](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints.md) · [All operations](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kalshi/kalshi-trade-api-manual-endpoints/revisions/6e6402bf667d/schema)