GET/rewards/user/total

Get total earnings for user by date

Returns the summed total rewards earnings for a user on a provided day, grouped by asset address. Requires CLOB L2 Auth headers.

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, aggregates both native and sponsored earnings

Example

curl -X GET "https://clob.polymarket.com/rewards/user/total?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.

Returns a list of objects with these fields

Field	Type	Description
date	string	Date of the earnings
asset_address	string	Address of the reward asset
maker_address	string	Address of the maker
earnings	number	Total amount of earnings in the asset
asset_rate	number	Exchange rate of the asset

Responses

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

Related endpoints

GET /rewards/user 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.