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

# Fee Events

> Browse fee charged events across all Polymarket trades.

Returns fee events from the Polymarket exchange. Each fee event records the receiver, amount, and associated transaction.

## Request

```
GET /v3/fees
```

### Query parameters

| Parameter | Type    | Default | Description                          |
| --------- | ------- | ------- | ------------------------------------ |
| `after`   | integer | --      | Start of time range (Unix timestamp) |
| `before`  | integer | --      | End of time range                    |
| `limit`   | integer | 100     | Max 300                              |
| `offset`  | integer | 0       | Pagination offset                    |

### By receiver

```
GET /v3/fees/{receiver}
```

Returns fees received by a specific address.

## Example

```bash theme={null}
curl https://api.polynode.dev/v3/fees?limit=1
```

```json theme={null}
{
  "data": [
    {
      "id": "0x1e20bc6a2107b61fa179b3ab17047b43569031e238f2b4ac92d9fa25a2822e3d_633",
      "timestamp": "1778962419",
      "receiver": "0x115f48dc2a731aa16251c6d6e1befc42f92accc9",
      "amount": "318480",
      "transaction_hash": "0x1e20bc6a2107b61fa179b3ab17047b43569031e238f2b4ac92d9fa25a2822e3d"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 3
}
```

When fetching `GET /v3/fees/{receiver}`, the `receiver` field is omitted from each row (it's redundant — every row matches the path parameter).

## Response fields

| Field              | Type   | Description                 |
| ------------------ | ------ | --------------------------- |
| `id`               | string | Unique fee event ID         |
| `timestamp`        | string | Unix timestamp              |
| `receiver`         | string | Fee receiver address        |
| `amount`           | string | Fee amount (6-decimal USDC) |
| `transaction_hash` | string | On-chain transaction hash   |