---
title: "Get Credit History"
method: GET
path: "/portfolio/credit_history"
tags: ["portfolio"]
---

# Get Credit History

`GET /portfolio/credit_history`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/portfolio/credit_history`
- Auth: API key in header `KALSHI-ACCESS-KEY` and API key in header `KALSHI-ACCESS-SIGNATURE` and API key in header `KALSHI-ACCESS-TIMESTAMP`

Returns the authenticated member's credit history, newest first.
Filters apply to credit creation time: `min_ts` is inclusive and `max_ts` is exclusive.

## Query parameters

- `limit` integer
- `cursor` string
- `min_ts` integer
- `max_ts` integer

## Response `200`

Credit history retrieved successfully

- GetCreditHistoryResponse
  - `credits` CreditHistory[], required
    - `credit_id` string, required: Unique credit identifier.
    - `type` string, required: Credit category.
    - `status` 'unknown' | 'pending' | 'failed' | 'applied', required: Credit processing status.
    - `amount_dollars` string, required: Fixed-point US dollar string. Most request fields accept 2-4 decimal places (e.g., "0.56", "0.5600"); responses emit up to 6. Valid quote intervals for a given market are constrained by that market's price level structure.
    - `reason` string, required: Credit description, which may include a market or event ticker.
    - `created_time` string, date-time, required: Time the credit was created.
  - `cursor` string, required: Pagination cursor; empty when there are no more results.

## Other responses

- `400`: Bad request - invalid input
- `401`: Unauthorized - authentication required
- `403`: Forbidden - insufficient permissions
- `500`: Internal server error

## Changes

- **2026-10-27** `984d842a11b7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/portfolio/credit_history/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)