Summary
Fans who want to buy into a creator at a specific price have no way to know when that price is reached without manually checking. A price alert system lets a fan register a target price and a callback URL, and the server fires the webhook when the creator's key price crosses that threshold. This turns passive watchers into active buyers at the right moment.
Scope
- Add
POST /alerts to register an alert: { creator_id, wallet_address, target_price, direction, callback_url }
direction is either above (fire when price rises past target) or below (fire when price drops below target)
- Add
DELETE /alerts/:id to cancel a registered alert
- When the indexer processes a trade event and the new price crosses any registered threshold, fire the registered
callback_url via HTTP POST with payload: { creator_id, triggered_price, target_price, direction, timestamp }
- A fired alert is automatically deleted after delivery (one-shot)
- Failed webhook delivery is retried up to 3 times with exponential backoff
Acceptance Criteria
Coordinate on Telegram
Summary
Fans who want to buy into a creator at a specific price have no way to know when that price is reached without manually checking. A price alert system lets a fan register a target price and a callback URL, and the server fires the webhook when the creator's key price crosses that threshold. This turns passive watchers into active buyers at the right moment.
Scope
POST /alertsto register an alert:{ creator_id, wallet_address, target_price, direction, callback_url }directionis eitherabove(fire when price rises past target) orbelow(fire when price drops below target)DELETE /alerts/:idto cancel a registered alertcallback_urlvia HTTP POST with payload:{ creator_id, triggered_price, target_price, direction, timestamp }Acceptance Criteria
DELETE /alerts/:idcancels a pending alert before it firesCoordinate on Telegram