Incentives API

The Incentives API provides access to active incentive programs and your earned rewards. For details on how incentive programs work, see the Incentive Programs overview; for how liquidity programs score — Target Size, Discount Factor, and Max Spread — see the Liquidity Incentive Program page.

Endpoints

Method	Endpoint	Auth	Description
`GET`	`/v1/incentives`	None	Get incentive programs
`GET`	`/v1/incentives/earnings`	Required	Get your incentive earnings

Authentication Required for EarningsThe /v1/incentives/earnings endpoint requires API key authentication. See the Authentication guide for details. The /v1/incentives endpoint is public and requires no authentication.

Get Incentive Programs

Returns incentive programs for each market.

GET /v1/incentives?pageSize=10&symbols=aec-nba-bos-nyk-2026-04-01

Query Parameters

Parameter names accept both camelCase (pageSize) and snake_case (page_size) forms.

Parameter	Type	Required	Description
`pageSize`	integer	No	Number of markets per page
`pageToken`	string	No	Pagination token from a previous response’s `nextPageToken`
`symbols`	string[]	No	Filter by market symbols
`orderBy`	string	No	Sort field: `created_at` (default)
`orderDirection`	string	No	Sort direction: `desc` (default) or `asc`
`statuses`	string[]	No	Filter by status: `active`, `closed`, `pending`

Response

{
  "programs": [
    {
      "marketSlug": "aec-nba-bos-nyk-2026-04-01",
      "timePeriods": [
        {
          "programId": "nba_t1_ml_early",
          "programType": "liquidityProgram",
          "start": "2026-03-28T04:00:00Z",
          "end": "2026-04-01T21:00:00Z",
          "rewardPool": 3000.0,
          "status": "closed",
          "discountFactor": 0.40,
          "targetSize": 20000,
          "period": "early",
          "createdAt": "2026-03-28T01:00:00Z"
        },
        {
          "programId": "nba_t1_ml_live",
          "programType": "liquidityProgram",
          "start": "2026-04-01T21:00:00Z",
          "rewardPool": 3000.0,
          "status": "active",
          "discountFactor": 0.35,
          "targetSize": 20000,
          "period": "live",
          "createdAt": "2026-03-28T01:00:00Z",
          "maxSpread": 0.035
        }
      ]
    }
  ],
  "nextPageToken": "abc123"
}

end is omitted when the program’s final end time is not known yet, such as an in-progress live game.

IncentiveProgram Fields

Field	Type	Description
`marketSlug`	string	Market identifier
`timePeriods`	TimePeriod[]	Incentive periods for this market

TimePeriod Fields

Field	Type	Description
`programId`	string	Unique program period identifier
`programType`	string	Program type (e.g., `liquidityProgram`)
`start`	string	ISO 8601 start timestamp
`end`	string	ISO 8601 end timestamp. Omitted when the end time is not known yet
`rewardPool`	number	Total reward pool for this period in USD
`status`	string	`active`, `closed`, or `pending`
`discountFactor`	number	Discount factor for scoring (optional)
`targetSize`	integer	Liquidity programs: minimum aggregate resting size, in contracts, on a side of the book for that side to qualify (optional)
`maxSpread`	number	Liquidity programs only. Optional half-width in price dollars (`0.035` = 3.5¢ from mid, so a 7¢ gap). Where set, a second pays only if both sides of the book reach `targetSize` with each size-adjusted price within `maxSpread` of the midpoint. Omitted (never `0`) when the program has no Max Spread. See the note below
`period`	string	Reward period type: `early`, `day_of`, `live`, etc.
`createdAt`	string	ISO 8601 timestamp when the program was created

Reading maxSpread. A liquidity program may carry a maximum spread from the midpoint. Where it does:

Units. maxSpread is in price dollars of a $1 contract (0.035 = 3.5¢). The docs pages and polymarket.us/rewards quote the same value in cents; the API always returns dollars. It is a half-width: the two sides may be up to 2 × maxSpread apart (3.5¢ from the midpoint = a 7¢ gap).
What is compared. Once per sampled second, each side of the book is walked from its best price outward, one whole price level at a time, until the resting size on that side (all participants combined) reaches targetSize. The price level that gets there is that side’s size-adjusted price. The midpoint is halfway between the two size-adjusted prices — not the best-bid/best-offer midpoint. A small order at the best price counts toward that side’s depth like any other order; it moves the size-adjusted price only when it is what carries the side to targetSize.
Pass / fail. This is a test of the book, not of each trader: you do not have to quote both sides yourself. The second is scored as usual (every order from the best price through the size-adjusted price qualifies, weighted by its distance from that side’s best price and by its size) when both sides reach targetSize and each size-adjusted price is no more than maxSpread from the midpoint — a gap of exactly 2 × maxSpread passes. If either side never reaches targetSize, or the gap is wider than 2 × maxSpread, nobody is paid for that second, including makers quoting tightly and including a side that did reach targetSize. Once a second qualifies, a one-sided quote still earns on the side it rests on. A failed second still counts toward the period’s total, so its share of rewardPool is forfeited, not shifted to other seconds or other makers.
Tick size. The check is in dollars, so a given maxSpread means the same thing on 1¢-tick and 0.1¢-tick markets.
Omission. The key is absent (never 0) when a program has no Max Spread; it is a liquidityProgram field. Programs without a Max Spread score each side independently, as before.
Scope. The value applies to every scored second of that timePeriods[] entry. Parameters can differ between time periods of the same market, so read maxSpread per entry rather than per market.

Full explanation and worked example: What is Max Spread?.

Get Incentive Earnings

Returns incentive earnings for the authenticated user.

GET /v1/incentives/earnings?startDate=2026-03-21&marketSlug=aec-nba-bos-nyk-2026-04-01

Query Parameters

Parameter names accept both camelCase (startDate) and snake_case (start_date) forms.

Parameter	Type	Required	Description
`startDate`	string	No	Start date filter (`YYYY-MM-DD`). Defaults to `2026-03-21`
`endDate`	string	No	End date filter (`YYYY-MM-DD`)
`marketSlug`	string	No	Filter by market
`programType`	string	No	Filter by program type (e.g., `liquidityProgram`)

Response

{
  "rewards": [
    {
      "reward": 1828.62,
      "programType": "liquidityProgram",
      "marketSlug": "tsc-nba-ny-okc-2026-03-29-223pt5",
      "date": "2026-03-30",
      "status": "PAID"
    },
    {
      "reward": 142.50,
      "programType": "liquidityProgram",
      "marketSlug": "tsc-nba-ny-okc-2026-03-29-223pt5",
      "date": "2026-03-30",
      "status": "PENDING"
    },
    {
      "reward": 325.97,
      "programType": "liquidityProgram",
      "marketSlug": "aec-cbb-cabap-kan-2026-03-20",
      "date": "2026-03-29",
      "status": "PAID"
    }
  ]
}

Each day represents rewards earned midnight to midnight ET. A single market on a single date may return multiple rows — one per payout status (PAID, PENDING, SKIPPED). Sum across statuses (or filter to one) when aggregating per market and date.

UserReward Fields

Field	Type	Description
`reward`	number	Reward amount in USD (sum of payouts for this market and date with this status)
`programType`	string	Program type (e.g., `liquidityProgram`)
`marketSlug`	string	Market identifier
`date`	string	Reward date in Eastern Time (`YYYY-MM-DD`)
`status`	string	Payout disposition: `PAID`, `PENDING`, or `SKIPPED`. A single `marketSlug` + `date` may appear once per status.

Rate Limits

Endpoint	Rate Limit
`GET /v1/incentives`	5 requests per second
`GET /v1/incentives/earnings`	5 requests per second

Overview

Health

Trading

Combos

RFQs

Report

Positions

Funding

Order Book

Settlement

Reference Data

Accounts

Payments

Incentives

Incentives API Overview

Incentives API

Endpoints

Get Incentive Programs

Query Parameters

Response

IncentiveProgram Fields

TimePeriod Fields

Get Incentive Earnings

Query Parameters

Response

UserReward Fields

Rate Limits

​Incentives API

​Endpoints

​Get Incentive Programs

​Query Parameters

​Response

​IncentiveProgram Fields

​TimePeriod Fields

​Get Incentive Earnings

​Query Parameters

​Response

​UserReward Fields

​Rate Limits

Incentives API

Endpoints

Get Incentive Programs

Query Parameters

Response

IncentiveProgram Fields

TimePeriod Fields

Get Incentive Earnings

Query Parameters

Response

UserReward Fields

Rate Limits