Skip to content

Spec drift: polymarket — rewards endpoints missing from CLOB spec (GET /rewards/markets/current and user variants) #535

@realfishsam

Description

@realfishsam

Summary

Polymarket CLOB API exposes several rewards-related endpoints that are not present in core/specs/polymarket-clob.yaml. These endpoints allow querying current reward programs, user reward earnings, and reward claim status.

Impact

MEDIUM — PMXT cannot surface Polymarket rewards/incentives data for users. This is increasingly important as Polymarket uses rewards to drive liquidity provision.

Details

Missing endpoints:

  1. GET /rewards/markets/current — list markets currently in an active rewards program with reward rates
  2. GET /rewards/{market_condition_id} — reward details for a specific market
  3. GET /rewards/user/{address} — user's earned rewards across all reward programs
  4. GET /rewards/user/{address}/claimable — user's claimable (pending) reward amounts

All endpoints require no authentication for public data; user-specific endpoints require L1 auth.

Required Fix

Add the rewards endpoint group to core/specs/polymarket-clob.yaml with appropriate schemas. Consider whether to implement these in the Polymarket fetcher or surface them as a separate data category.

Metadata

Metadata

Assignees

No one assigned

    Labels

    spec-driftCached OpenAPI spec out of date vs venue's live docs

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions