GET/rewards/user

Get earnings for user by date

Returns an array of user earnings per market for a provided day. Requires CLOB L2 Auth headers. Results are paginated (100 items per page). Use next_cursor to fetch subsequent pages. A next_cursor value of "LTE=" indicates the last page.

Base URL: https://clob.polymarket.com
Auth: L2 API credentials (key, secret, passphrase)POLY_API_KEY, POLY_ADDRESS, POLY_SIGNATURE, POLY_PASSPHRASE, POLY_TIMESTAMP
Rate limit: 9,000 req / 10s (900 per second)
Limit applies to: CLOB API general

Parameters

Name	In	Type	Required	Description
date	query	string	yes	Date in YYYY-MM-DD format
signature_type	query	integer	no	Signature type for address derivation (required for API KEY auth): - 0: EOA - 1: POLY_PROXY - 2: POLY_GNOSIS_SAFE
maker_address	query	string	no	Maker address to query earnings for
sponsored	query	boolean	no	If true, returns sponsored-only earnings
next_cursor	query	string	no	Pagination cursor from previous response

Example

curl -X GET "https://clob.polymarket.com/rewards/user?date=<date>" \
  -H "POLY_API_KEY: $POLY_API_KEY" \
  -H "POLY_ADDRESS: $POLY_ADDRESS" \
  -H "POLY_SIGNATURE: $POLY_SIGNATURE" \
  -H "POLY_PASSPHRASE: $POLY_PASSPHRASE" \
  -H "POLY_TIMESTAMP: $POLY_TIMESTAMP"

L2 requests are signed with HMAC-SHA256 using your API secret, and the timestamp is part of the signature, so keep the machine's clock accurate. A missing credential or a stale signature both come back as Unauthorized/Invalid api key. The Python SDK signs for you.

Response fields

Field	Type	Description
limit	integer	Maximum number of items per page
count	integer	Number of items in the current response
next_cursor	string	Cursor for the next page. "LTE=" indicates the last page.
data	object[]

Responses

Status	Meaning
200	Successfully retrieved user earnings
400	Bad request - Invalid parameters
401	Unauthorized - Invalid API key or authentication failed
500	Internal server error

Related endpoints

GET /rewards/user/total CLOB API
GET /rewards/user/percentages CLOB API
GET /rewards/user/markets CLOB API
GET /rewards/markets/current CLOB API
GET /rewards/markets/{condition_id} CLOB API
GET /rewards/markets/multi CLOB API

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.