# GET /polymarket/top-events

**Operation ID:** `GetPolymarketTopEvents`

Polymarket top events leaderboard

Returns the top (trader, event) entries by PnL for a period: 1d, 1w, 1m, or all (default 1d). Each entry sums a trader's PnL across every market within a single Polymarket event. Order desc for top wins or asc for top losses.

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `period` | query | string | No | Time period: 1d, 1w, 1m, all. Default: 1d Example: `"1d"` |
| `order` | query | string | No | Sort order: desc (top wins) or asc (top losses). Default: desc Example: `"asc"` |
| `limit` | query | integer | No | Max entries (1-200). Default: 100 Example: `100` |
| `offset` | query | integer | No | Pagination offset. Default: 0 Example: `0` |

## Responses

- **200**: OK
  **Schema**: (array)
    - **(items)**: ([PolymarketTopEventEntry](https://arkm.com/llms/schemas/PolymarketTopEventEntry.md))
- **400**: Bad Request
- **500**: Internal Server Error

## Example

```bash
curl -X GET "https://api.arkm.com/polymarket/top-events?period=1d&order=asc&limit=100&offset=0" \
  -H "API-Key: YOUR_API_KEY"
```