Back to FAQIntegration
Integration

Can I replay historical blockchain events?

One of the key strengths of Blockferry is its ability to backfill or recover data. If your system was down or missed transactions, you can easily replay those events.

How to trigger a replay

bash
  agy webhooks replay --rule-id rule_abc123 --from-block 21540000 --to-block 21545000
  • **Via the Dashboard:** Navigate to your webhook rule, click "Replay Events", select your start date/time, and trigger the stream.
  • **Via the CLI:** Execute the `agy replay` command:
  • **Via the API:** Send a POST request to `/v1/webhooks/replay` with the desired range parameters.

Safety Guarantees

During a replay, Blockferry automatically sets the X-Blockferry-Replay header to true. Your backend can use this header to bypass side effects (like sending email alerts or triggering payment processes twice) while safely updating your application database.