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

Documentation Index

Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

Returns maker rebate records reported by Polymarket’s public rebate endpoint for one maker address and one date. Maker rebates are Polymarket accounting credits. They are not the same value as indexed OrderFilled.fee, and they should not be treated as trader fees paid.
Polymarket’s upstream rebate endpoint expects the 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

ParameterTypeDefaultDescription
datestringcurrent UTC dateDate 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_clob_rebates_current",
  "rebate_semantics": "maker rebates reported by Polymarket upstream for one maker/date; not derived from v1.fee_charged_event",
  "elapsed_ms": 271
}

​
Response fields

FieldTypeDescription
addressstringWallet or maker address, lowercased
datestringDate used for the upstream rebate lookup
rebatesarrayPolymarket upstream rebate records
rows_returnedintegerNumber of rebate records returned
total_rebated_fees_usdcnumberSum of rebated_fees_usdc across returned records when present
sourcestringpolymarket_clob_rebates_current
rebate_semanticsstringSource and accounting note
upstream_statusintegerPresent when Polymarket returned an invalid maker-address response that PolyNode converted to an empty result
upstream_warningobjectPresent with the upstream warning body for invalid maker-address responses
hintstringPresent when a Safe/proxy address may need to be resolved to a maker EOA
elapsed_msintegerServer-side request time in milliseconds
The objects inside rebates are passed through from Polymarket. Their fields can change upstream; when a record includes rebated_fees_usdc, PolyNode includes it in total_rebated_fees_usdc.

​
Errors

HTTPWhen
400Invalid wallet address
400Invalid date format
401Missing or invalid PolyNode API key
502Polymarket rebate upstream failed or returned invalid JSON

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

Maker rebate records