Skip to main content
GET
/
v1
/
radar
/
all
Get All Radar
curl --request GET \
  --url https://api.shoal.xyz/v1/radar/all \
  --header 'Authorization: Bearer <token>'
Radar events are structured summaries of noteworthy activity across the digital asset ecosystem — partnerships, product launches, regulatory developments, security incidents, and more. Each event includes the organizations involved, a human-readable summary, bullet points, and the original source posts. Use this endpoint to pull a chronological feed of all radar events since a given timestamp. Ideal for building a real-time news feed or keeping a dashboard up to date with incremental polling.

​
Query Parameters

  • since (string, required) — ISO 8601 timestamp. Only return events newer than this time. See Polling Guide.
  • limit (integer, default: 50, max: 50)
  • offset (integer, default: 0, max: 500)
  • cursor (string, optional) — Opaque cursor token from a previous next_cursor response. When provided, since is required and offset is ignored.
The since parameter is required. Requests without it return 400:
{ "error": "The 'since' parameter is required. Use an ISO 8601 timestamp (e.g. 2026-02-01T00:00:00Z)." }
Invalid timestamps (e.g. since=garbage) are also rejected with 400.

​
Request

cURL
curl -X GET "https://api.shoal.xyz/v1/radar/all?since=2026-02-01T00:00:00Z&limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (200)

{
  "limit": 50,
  "offset": 0,
  "since": "2026-02-01T00:00:00Z",
  "next_cursor": "eyJ0cyI6IjIwMjYtMDItMjhUMDY6MTg6NDQuMDAwWiIsImlkIjo2NTB9",
  "data": [
    {
      "id": 650,
      "title": "Event Title",
      "eventCategory": "partnership",
      "eventSubcategory": "acquisition",
      "globalSummary": "Summary of the event.",
      "bulletSummary": ["Bullet point 1.", "Bullet point 2."],
      "eventOwner": [
        {
          "id": 968,
          "label": "Organization Name",
          "type": "project",
          "aliases": ["Alias"]
        }
      ],
      "eventParticipants": [
        {
          "id": 205,
          "label": "Participant Name",
          "type": "government_institution",
          "aliases": ["Alias"]
        }
      ],
      "posts": [
        {
          "id": 46970,
          "content": "Post content",
          "url": "https://x.com/...",
          "timestamp": "2026-02-28T06:18:44+00:00"
        }
      ],
      "latestPostTimestamp": "2026-02-28T06:18:44.000Z",
      "signal": 7.01
    }
  ]
}