KAkalshi
incentive-programs

Get Incentives

Changed on

List incentives with optional filters. Incentives are rewards programs for trading activity on specific markets.

get/incentive_programs

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/incentive_programs
  • Auth
    none declared

Query parameters

status'all' | 'active' | 'upcoming' | 'closed' | 'paid_out'

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

type'all' | 'liquidity' | 'volume' | 'margin_maker_volume' | 'margin_taker_volume'

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

incentive_descriptionstring

Filter by exact incentive description.

limitinteger

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

cursorstring

Cursor for pagination

Response

Incentive programs retrieved successfully

next_cursorstring

Cursor for pagination to get the next page of results

Example response

{
  "incentive_programs": [
    {
      "target_size_fp": "10.00"
    }
  ]
}

Changes

  • 11aa0ec82b47Revision changes
    • warning

      added the new margin_taker_volume enum value to the // response property for the response status

    • info

      added the new enum value margin_taker_volume to the query request parameter type

  • 6aec27d55fbaRevision changes
    • warning

      added the new margin_maker_volume enum value to the // response property for the response status

    • info

      added the new enum value margin_maker_volume to the query request parameter type

    • info

      added the optional property // to the response with the status