Skip to main content
GET
/
incentive_programs
Get Incentives
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/incentive_programs
{
  "incentive_programs": [
    {
      "id": "<string>",
      "market_id": "<string>",
      "market_ticker": "<string>",
      "incentive_description": "<string>",
      "start_date": "2023-11-07T05:31:56Z",
      "end_date": "2023-11-07T05:31:56Z",
      "period_reward": 123,
      "paid_out": true,
      "discount_factor_bps": 123,
      "target_size_fp": "10.00"
    }
  ],
  "next_cursor": "<string>"
}

Query Parameters

​
status
enum<string>

Status filter. Can be "all", "active", "upcoming", "closed", or "paid_out". Default is "all".

Available options:
all,
active,
upcoming,
closed,
paid_out
​
type
enum<string>

Type filter. Can be "all", "liquidity", or "volume". Default is "all".

Available options:
all,
liquidity,
volume
​
incentive_description
string

Filter by exact incentive description.

​
limit
integer

Number of results per page. Defaults to 100. Maximum value is 10000.

Required range: 1 <= x <= 10000
​
cursor
string

Cursor for pagination

Response

Incentive programs retrieved successfully

​
incentive_programs
object[]
required
​
next_cursor
string

Cursor for pagination to get the next page of results