New API users should migrate to deposit wallets. Read the migration guide.
Events
Markets
Orderbook & Pricing
- GETGet order book
- POSTGet order books (request body)
- GETGet market price
- GETGet market prices (query parameters)
- POSTGet market prices (request body)
- GETGet midpoint price
- GETGet midpoint prices (query parameters)
- POSTGet midpoint prices (request body)
- GETGet spread
- POSTGet spreads
- GETGet last trade price
- GETGet last trade prices (query parameters)
- POSTGet last trade prices (request body)
- GETGet prices history
- POSTGet batch prices history
- GETGet fee rate
- GETGet fee rate by path parameter
- GETGet tick size
- GETGet tick size by path parameter
- GETGet CLOB market info
- GETGet server time
Orders
Rewards
Profile
- GETGet public profile by wallet address
- GETGet current positions for a user
- GETGet closed positions for a user
- GETGet user activity
- GETGet total value of a user's positions
- GETGet trades for a user or markets
- GETGet total markets a user has traded
- GETGet positions for a market
- GETDownload an accounting snapshot (ZIP of CSVs)
Leaderboard
Tags
Bridge
Relayer
Get total earnings for user by date
curl --request GET \
--url https://clob.polymarket.com/rewards/user/total \
--header 'POLY_ADDRESS: <api-key>' \
--header 'POLY_API_KEY: <api-key>' \
--header 'POLY_PASSPHRASE: <api-key>' \
--header 'POLY_SIGNATURE: <api-key>' \
--header 'POLY_TIMESTAMP: <api-key>'[
{
"date": "2024-04-09T00:00:00Z",
"asset_address": "0x9c4E1703476E875070EE25b56A58B008CFb8FA78",
"maker_address": "0xD527CCdBEB6478488c848465F9947bDA3C2e6994",
"earnings": 1.59984,
"asset_rate": 0.999357
},
{
"date": "2024-04-09T00:00:00Z",
"asset_address": "0x69308FB512518e39F9b16112fA8d994F4e2Bf8bB",
"maker_address": "0xD527CCdBEB6478488c848465F9947bDA3C2e6994",
"earnings": 8.187219,
"asset_rate": 3.51
}
]
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.
GET
/
rewards
/
user
/
total
Get total earnings for user by date
curl --request GET \
--url https://clob.polymarket.com/rewards/user/total \
--header 'POLY_ADDRESS: <api-key>' \
--header 'POLY_API_KEY: <api-key>' \
--header 'POLY_PASSPHRASE: <api-key>' \
--header 'POLY_SIGNATURE: <api-key>' \
--header 'POLY_TIMESTAMP: <api-key>'[
{
"date": "2024-04-09T00:00:00Z",
"asset_address": "0x9c4E1703476E875070EE25b56A58B008CFb8FA78",
"maker_address": "0xD527CCdBEB6478488c848465F9947bDA3C2e6994",
"earnings": 1.59984,
"asset_rate": 0.999357
},
{
"date": "2024-04-09T00:00:00Z",
"asset_address": "0x69308FB512518e39F9b16112fA8d994F4e2Bf8bB",
"maker_address": "0xD527CCdBEB6478488c848465F9947bDA3C2e6994",
"earnings": 8.187219,
"asset_rate": 3.51
}
]
Documentation Index
Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Your API key
Ethereum address associated with the API key
HMAC signature of the request
API key passphrase
Unix timestamp of the request
Query Parameters
Date in YYYY-MM-DD format
Signature type for address derivation (required for API KEY auth):
- 0: EOA
- 1: POLY_PROXY
- 2: POLY_GNOSIS_SAFE
Available options:
0, 1, 2 Maker address to query earnings for
If true, aggregates both native and sponsored earnings
Response
Successfully retrieved total user earnings
Was this page helpful?
⌘I