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>'

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.

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.