Wallet Maker Rebates

Get Polymarket-reported maker rebates for a wallet and date.

GET /v3/wallets/{address}/rebates

Wallet maker rebates

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{address}/rebates \
  --header 'x-api-key: <api-key>'

Returns maker rebate records reported by Polymarket for one maker address and one date.

Maker rebates are Polymarket accounting credits. They are not the same value as trader fees paid.

Polymarket rebate lookups are keyed by CLOB maker/signing address. If you pass a Safe or proxy wallet that Polymarket does not accept as a maker address, PolyNode returns an empty rebates array with an explanatory hint.

Request

GET /v3/wallets/{address}/rebates

Query parameters

Parameter	Type	Default	Description
date	string	current UTC date	Date in YYYY-MM-DD format

Example

curl "https://api.polynode.dev/v3/wallets/0x8ecb4b228e07b6ddc58a32997093032a6907b8f6/rebates"

{
  "address": "0x8ecb4b228e07b6ddc58a32997093032a6907b8f6",
  "date": "2026-05-27",
  "rebates": [],
  "rows_returned": 0,
  "total_rebated_fees_usdc": 0,
  "source": "polymarket_rebates",
  "rebate_semantics": "Maker rebates reported for one maker/date. Separate from trader-paid fees.",
  "elapsed_ms": 271
}

Response fields

Field	Type	Description
address	string	Wallet or maker address, lowercased
date	string	Date used for the rebate lookup
rebates	array	Polymarket rebate records
rows_returned	integer	Number of rebate records returned
total_rebated_fees_usdc	number	Sum of rebated_fees_usdc across returned records when present
source	string	Dataset label
rebate_semantics	string	Accounting note
provider_status	integer	Present when the rebate data provider returned an invalid maker-address response that PolyNode converted to an empty result
provider_warning	object	Present with the provider warning body for invalid maker-address responses
hint	string	Present when a Safe/proxy address may need to be resolved to a maker EOA
elapsed_ms	integer	Server-side request time in milliseconds

The objects inside rebates follow Polymarket’s rebate record format. When a record includes rebated_fees_usdc, PolyNode includes it in total_rebated_fees_usdc.

Errors

HTTP	When
400	Invalid wallet address
400	Invalid date format
401	Missing or invalid PolyNode API key
502	Temporary rebate data provider failure

Authorizations

x-api-key · string · header · required

Path Parameters

address · string · required

Wallet or CLOB maker address

Query Parameters

date · string<date>

UTC date in YYYY-MM-DD format. Defaults to current UTC date.

Response

200

Maker rebate records