> ## 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 Top Signals

> Get the highest-scoring signal events

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

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

### Response (200)

```json theme={null}
{
  "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.