Skip to main content
GET
/
v1
/
signal
/
byOrganizationId
Get Signals by Organization ID
curl --request GET \
  --url https://api.shoal.xyz/v1/signal/byOrganizationId \
  --header 'Authorization: Bearer <token>'
Returns scored signal events for a specific canonical organization. Use this to monitor a single project for market-moving activity, or to power an organization detail page with its most significant events. Results prioritize direct organization matches and may also include strongly related context when it is clearly relevant, such as affiliated foundations, governance bodies, core teams, or native assets.

​
Query Parameters

  • id (integer, required) — Organization ID
  • limit (integer, default: 50, max: 50)
  • offset (integer, default: 0, max: 500)
  • since (string, optional) — ISO 8601 timestamp. Only return events newer than this time. See Polling Guide.
  • cursor (string, optional) — Opaque cursor token from a previous next_cursor response. When provided, since is required and offset is ignored.

​
Request

cURL
curl -X GET "https://api.shoal.xyz/v1/signal/byOrganizationId?id=526" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

Same as /v1/signal/all but filtered for one organization. Includes next_cursor (string or null) for cursor-based pagination.

​
Notes

  • The id should be a canonical organization ID from the organizations endpoints.
  • Direct matches rank first.
  • Strongly related organization and native-asset activity may also appear when it improves recall for the requested organization.

​
Errors

  • 400 if id missing
  • 500 on internal server error