Skip to main content
GET
/
v1
/
replay
/
global
Get Global Replay
curl --request GET \
  --url https://api.shoal.xyz/v1/replay/global \
  --header 'Authorization: Bearer <token>'
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

ParameterTypeRequiredDescription
sincestringYesISO 8601 timestamp; must be within the last 30 days
limitintegerNoMax results (default 10, max 10)
offsetintegerNoOffset for the first page only (max 100)
cursorstringNoShoal cursor for subsequent pages

​
Request

cURL
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)

{
  "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