Sign in
latestOpenAPI 3.0.02026-08-22107190316.9 KB

6aec27d55fba

incentive-programs

Get Incentives

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

get/incentive_programs

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'

Type filter. Can be "all", "liquidity", "volume", or "margin_maker_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"
    }
  ]
}