Skip to main content
GET
/
v1
/
organizations
/
:id
/
signal-history
Signal History
curl --request GET \
  --url https://api.shoal.xyz/v1/organizations/:id/signal-history \
  --header 'Authorization: Bearer <token>'
Returns a day-by-day breakdown of how many radar and signal events an organization generated over a given period (up to 90 days). Use this to visualize activity trends, detect spikes in coverage, or compare an organization’s recent activity level to its baseline.

​
Path Parameters

  • id (integer, required) - Organization ID

​
Query Parameters

  • days (integer, default: 30, max: 90)

​
Request

cURL
curl -X GET "https://api.shoal.xyz/v1/organizations/526/signal-history?days=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (200)

{
  "data": {
    "organizationId": 526,
    "label": "Ethereum",
    "history": [
      {
        "date": "2026-02-28",
        "signalCount": 3,
        "radarCount": 7
      },
      {
        "date": "2026-02-27",
        "signalCount": 1,
        "radarCount": 12
      }
    ]
  }
}

​
Errors

  • 400 if id missing or invalid
  • 404 if organization not found
Use this endpoint to track how an organization’s signal activity trends over time. Useful for dashboards and monitoring.