Skip to main content
GET
/
v1
/
signal
/
top
Get Top Signals
curl --request GET \
  --url https://api.shoal.xyz/v1/signal/top \
  --header 'Authorization: Bearer <token>'
Returns the highest-scoring signal events, sorted by signal score descending. Use this to quickly surface the most important events without fetching and sorting the full signal feed yourself. Great for headline widgets, alert summaries, or “top stories” sections.

​
Query Parameters

  • limit (integer, default: 10, max: 50)

​
Request

cURL
curl -X GET "https://api.shoal.xyz/v1/signal/top?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (200)

{
  "limit": 10,
  "data": [
    {
      "id": 707,
      "title": "Event Title",
      "eventCategory": "partnership",
      "eventSubcategory": "acquisition",
      "globalSummary": "Summary of the event.",
      "bulletSummary": ["Bullet point 1.", "Bullet point 2."],
      "eventOwner": [
        {
          "id": 965,
          "label": "Organization Name",
          "type": "project",
          "aliases": []
        }
      ],
      "eventParticipants": [],
      "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": 12.45
    }
  ]
}
Events are sorted by signal score descending. Use this to surface the most important events in a single call instead of fetching all signals and sorting client-side.