Skip to main content
GET
/
account
/
limits
/
perps
Get Perps Account API Limits
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/account/limits/perps \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "usage_tier": "<string>",
  "read": {
    "refill_rate": 123,
    "bucket_capacity": 123
  },
  "write": {
    "refill_rate": 123,
    "bucket_capacity": 123
  },
  "grants": [
    {
      "level": "<string>",
      "source": "<string>",
      "expires_ts": 123
    }
  ]
}

Authorizations

​
KALSHI-ACCESS-KEY
string
header
required

Your API key ID

​
KALSHI-ACCESS-SIGNATURE
string
header
required

RSA-PSS signature of the request

​
KALSHI-ACCESS-TIMESTAMP
string
header
required

Request timestamp in milliseconds

Response

Perps account API tier limits retrieved successfully

​
usage_tier
string
required

User's API usage tier.

​
read
object
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.

​
write
object
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.

​
grants
object[]
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.