---
title: "Get Account API Limits"
method: GET
path: "/account/limits"
tags: ["account"]
---

# Get Account API Limits

`GET /account/limits`

## Request

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

Endpoint to retrieve the authenticated user's Predictions API usage tier and token-bucket limits. Public Predictions tiers include Basic, Advanced, Expert, Premier, Paragon, Prime, and Prestige.

## Response `200`

Account API tier limits retrieved successfully

- GetAccountApiLimitsResponse
  - `usage_tier` string, required: User's effective Predictions API usage tier for these limits (for example, basic, advanced, expert, premier, paragon, prime, or prestige).
  - `read` BucketLimit, required: Token-bucket budget for one rate-limit bucket. Each request deducts tokens equal to its endpoint cost; the bucket refills at refill_rate tokens per second up to bucket_capacity. A request is allowed if the bucket holds enough tokens to cover its cost; otherwise the request is rejected with HTTP 429.
    - `refill_rate` integer, required: Tokens added to the bucket per second.
    - `bucket_capacity` integer, required: Maximum tokens the bucket can hold. When equal to refill_rate the bucket holds one second of budget; larger values represent burst headroom that idle clients accumulate and can spend in a single pulse (e.g. write buckets at non-Basic tiers hold two seconds of budget).
  - `write` BucketLimit, required: Token-bucket budget for one rate-limit bucket. Each request deducts tokens equal to its endpoint cost; the bucket refills at refill_rate tokens per second up to bucket_capacity. A request is allowed if the bucket holds enough tokens to cover its cost; otherwise the request is rejected with HTTP 429.
    - `refill_rate` integer, required: Tokens added to the bucket per second.
    - `bucket_capacity` integer, required: Maximum tokens the bucket can hold. When equal to refill_rate the bucket holds one second of budget; larger values represent burst headroom that idle clients accumulate and can spend in a single pulse (e.g. write buckets at non-Basic tiers hold two seconds of budget).
  - `grants` ApiUsageLevelGrant[], required: The caller's active API usage level grants across exchange lanes, where each grant applies to its exchange_instance and usage_tier reflects the effective tier for the lane reported by this endpoint.
    - `exchange_instance` 'event_contract' | 'margined', required: The exchange instance type
    - `level` string, required: API usage level this grant confers (for example, expert, premier, paragon, prime, or prestige).
    - `expires_ts` integer, nullable: Unix timestamp (seconds) when the grant expires. Absent for permanent grants.
    - `source` string, required: How the grant was created: "volume" (earned from trading volume) or "manual" (assigned by Kalshi).

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

## Changes

- **2026-06-17** `5dacc8874900`: 1 info
  - added the required property `grants` to the response with the `200` status
- **2026-05-18** `7e31fc4590e0`: 2 breaking, 2 info
  - removed the required property `read_limit` from the response with the `200` status
  - removed the required property `write_limit` from the response with the `200` status
  - added the required property `read` to the response with the `200` status
  - added the required property `write` to the response with the `200` status
- **2026-01-26** `ea5437268cb9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/account/limits/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)