---
title: "List Polymarket rewards markets"
method: GET
path: "/polymarket/rewards/markets"
tags: ["Polymarket"]
---

# List Polymarket rewards markets

`GET /polymarket/rewards/markets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/polymarket/rewards/markets`
- Auth: API key in header `x-api-key`

Returns public rewards-market rows used by Polymarket's `/rewards` page. The `order_by` enum accepts `market`, `earnings`, `max_spread`, `min_size`, `rate_per_day`, `price`, `earning_percentage`, and `spread`; the `position` enum accepts `asc` and `desc`; the `tag_slug` enum accepts `all`, `politics`, `sports`, `crypto`, `pop-culture`, `middle-east`, `business`, and `science`.

## Query parameters

- `order_by` 'market' | 'earnings' | 'max_spread' | 'min_size' | 'rate_per_day' | 'price' | 'earning_percentage' | 'spread'
- `position` 'asc' | 'desc'
- `date` string
- `q` string
- `tag_slug` 'all' | 'politics' | 'sports' | 'crypto' | 'pop-culture' | 'middle-east' | 'business' | 'science'
- `cursor` string
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PolymarketRewardsMarketsResponseDoc
  - `code` integer
  - `data` PolymarketRewardsMarketsResponse
    - `count` integer: Number of reward markets returned on this page.
    - `cursor` string: Cursor that was used to fetch this page.
    - `date` string: Reward program date the markets apply to, in YYYY-MM-DD.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `has_more` boolean: `true` when more reward markets are available after this page.
    - `limit` integer: Maximum number of rows requested.
    - `markets` PolymarketRewardsMarketSummary[]: Reward markets on this page, one item per market.
      - `condition_id` string: Condition id that identifies the market on Polymarket.
      - `daily_reward_rate` number: Daily reward rate offered for the market.
      - `earning_percentage` number: Earning percentage Polymarket shows for the market.
      - `earnings` object[]: Reward earnings records for the market, as Polymarket returns them.
      - `event_id` string: Polymarket id of the event the market belongs to.
      - `event_slug` string: URL slug of the event the market belongs to.
      - `event_url` string: Link to the event on polymarket.com.
      - `image_url` string: URL of the market's image.
      - `maker_address` string: Maker address Polymarket reports for the market's rewards.
      - `market_competitiveness` number: Competitiveness score Polymarket shows for the market's rewards.
      - `market_id` string: Polymarket market id.
      - `market_slug` string: URL slug of the market.
      - `market_url` string: Link to the market on polymarket.com.
      - `question` string: Question the market asks.
      - `rewards_config` PolymarketRewardsConfigSummary[]: Reward programs configured for the market, one item per program.
        - `asset_address` string: Contract address of the token paid out as the reward.
        - `end_date` string: Date the reward program ends, in YYYY-MM-DD.
        - `id` integer: Id of the reward program configuration.
        - `rate_per_day` number: Reward amount paid per day.
        - `start_date` string: Date the reward program starts, in YYYY-MM-DD.
        - `total_rewards` number: Total reward amount configured for the program.
      - `rewards_max_spread` number: Maximum spread an order can have and still qualify for rewards.
      - `rewards_min_size` number: Minimum order size that qualifies for rewards.
      - `spread` number: Current spread of the market.
      - `tokens` PolymarketRewardsTokenSummary[]: Outcome tokens of the market with their prices, one item per outcome.
        - `outcome` string: Name of the outcome the token represents.
        - `price` number: Current price of the outcome token.
        - `token_id` string: Token id of the outcome.
      - `total_configured_rewards` number: Total rewards configured for the market.
      - `volume_24h` number: Trading volume of the market over the last 24 hours.
    - `next_cursor` string: Cursor to pass to fetch the next page.
    - `order_by` string: Field the markets are sorted by, for example `market`.
    - `position` string: Sort direction applied: `asc` or `desc`.
    - `q` string: Market question search text that was applied.
    - `source_url` string: URL the data was read from.
    - `tag_slug` string: Rewards category the markets were filtered by, for example `all` or `politics`.
    - `total_count` integer: Total number of reward markets matching the filters.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)