Skip to main content
GET
/
v1
/
radar
/
byCategory
Get Radar by Category
curl --request GET \
  --url https://api.shoal.xyz/v1/radar/byCategory \
  --header 'Authorization: Bearer <token>'
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.
  • cursor (string, optional) — Opaque cursor token from a previous next_cursor response. When provided, since is required and offset is ignored.

​
Request

cURL
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