> ## 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.

# Wallet Maker Rebates

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

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.

<Note>
  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`.
</Note>

## Request

```
GET /v3/wallets/{address}/rebates
```

### Query parameters

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

## Example

```bash theme={null}
curl "https://api.polynode.dev/v3/wallets/0x8ecb4b228e07b6ddc58a32997093032a6907b8f6/rebates"
```

```json theme={null}
{
  "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 |


## OpenAPI

````yaml GET /v3/wallets/{address}/rebates
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/wallets/{address}/rebates:
    get:
      tags:
        - V3 Wallets
      summary: Wallet maker rebates
      description: Get Polymarket-reported maker rebates for one maker address and date.
      operationId: v3_wallet_rebates
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
          description: Wallet or CLOB maker address
        - name: date
          in: query
          schema:
            type: string
            format: date
          description: UTC date in YYYY-MM-DD format. Defaults to current UTC date.
      responses:
        '200':
          description: Maker rebate records
        '400':
          description: Invalid wallet address or date
        '401':
          description: Unauthorized
        '502':
          description: Temporary rebate data provider failure
      security:
        - api_key: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````