🪝Webhooks

Stay in sync with effortless, automated data updates.

Webhooks are the most efficient way to keep your application up-to-date with the latest state changes. Instead of manually polling for updates, our webhooks notify your system the moment new data is processed and ready for use.

How it works

Our system follows a consistent cycle to ensure you are always working with the most accurate information:

  1. Node Updates: Approximately every 15–20 minutes, our nodes refresh with the latest state.

  2. Aggregation: Immediately after the refresh, we perform complex data aggregations to prepare your results.

  3. The Ping: As soon as the new state is ready, we send an automated "ping" (a POST request) to your designated webhook URL.

  4. Automatic Retrieval: Once your system receives this notification, it can automatically trigger a query to fetch the fresh results and update your local data.

Payload looks like this:

{
      event: "stateUpdated",
      timestamp: new Date().toISOString(),
      data: {},
}

Need a hand? If you’re new to setting up webhooks or run into any trouble getting your endpoint to listen reach out to our support team. We’re here to help you get synced up!

Last updated