> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoal.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Radar by Category

> Get radar events filtered by event category

Returns radar events filtered to a single event category. Use this when you only care about a specific type of activity (e.g. `regulation_legal`, `security_incident`, `partnership`).

## Query Parameters

* `category` (string, required) — Event category (e.g. `partnership`, `regulation_legal`, `product_development`, `market_update`, `security_incident`)
* `limit` (integer, default: 50, max: 50)
* `offset` (integer, default: 0, max: 500)
* `since` (string, optional) — ISO 8601 timestamp. Only return events newer than this time. See [Polling Guide](/guides/polling).
* `cursor` (string, optional) — Opaque cursor token from a previous `next_cursor` response. When provided, `since` is required and `offset` is ignored.

### Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/radar/byCategory?category=partnership" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

Same as `/v1/radar/all` but filtered by category. Includes `next_cursor` (string or null) for cursor-based pagination.

### Errors

* 400 if `category` missing
* 500 on internal server error