> ## 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 Global Replay

> Get a recent merged replay across radar and signal

Global Replay v1 is Shoal's first explicit premium replay surface.

Use it when you need:

* recent merged historical reconstruction
* one stream across both `radar` and `signal`
* a clearer replay product than stretching `/v1/radar/all` or `/v1/signal/all`

Do not treat it as unrestricted export.

## Access

* Access layer: `premium`
* Plan floor: `enterprise`
* Surface: `replay`

## Query Parameters

| Parameter | Type    | Required | Description                                         |
| --------- | ------- | -------- | --------------------------------------------------- |
| `since`   | string  | Yes      | ISO 8601 timestamp; must be within the last 30 days |
| `limit`   | integer | No       | Max results (default 10, max 10)                    |
| `offset`  | integer | No       | Offset for the first page only (max 100)            |
| `cursor`  | string  | No       | Shoal cursor for subsequent pages                   |

## Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/replay/global?since=2026-04-01T00:00:00Z&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response (200)

```json theme={null}
{
  "limit": 10,
  "since": "2026-04-01T00:00:00Z",
  "next_cursor": "eyJ0cyI6IjIwMjYtMDQtMTFUMTg6MjA6MDBaIiwiaWQiOjE4MjR9",
  "data": [
    {
      "id": 1824,
      "surface": "signal",
      "title": "Ethereum Foundation expands research grants",
      "eventCategory": "funding",
      "eventSubcategory": "grants",
      "summary": "The Ethereum Foundation expanded its research grants program with new funding for protocol research and ecosystem tooling.",
      "bullets": [
        "Funding expanded for protocol research.",
        "Ecosystem tooling is included in the new grants pool."
      ],
      "owners": [
        {
          "id": 23151,
          "label": "Ethereum Foundation",
          "type": "project",
          "aliases": ["EF"]
        }
      ],
      "participants": [],
      "evidence": [
        {
          "id": 778210,
          "content": "Ethereum Foundation expands research grants...",
          "url": "https://example.com/post",
          "timestamp": "2026-04-11T18:20:00Z"
        }
      ],
      "latestEvidenceTimestamp": "2026-04-11T18:20:00Z",
      "significance": 6.8
    }
  ]
}
```

## Notes

* Replay uses the canonical event aliases: `summary`, `bullets`, `owners`, `participants`, `evidence`, `latestEvidenceTimestamp`, `significance`.
* Each replay item includes `surface` so you can distinguish `signal` from `radar`.
* This route is intentionally narrower than full export.
* If you only need one organization, prefer `/v1/timeline/byOrganizationId`.
* If you only need recent monitoring, prefer the feed routes instead of replay.

## Errors

* 400 if `since` is missing
* 400 if `since` is older than 30 days
* 403 if the API key does not meet the plan floor
* 500 on internal server error