Get Notified#

Seesaw can notify you about wallet activity and market events through the channels enabled in your app. Notifications are convenience signals; always check the app or your wallet for the final on-chain state before acting.

Notification Types#

Type	What it means
Price alerts	A saved price alert condition was reached.
Order fills	An order fill was indexed for your wallet.
Trade resolution	A market you traded resolved.
Streak reminders	Your trading streak may be at risk.
Achievements	An achievement was unlocked.

Mobile push notifications require device permission and a registered push token. Web and email notification switches may appear before they are enabled for every deployment.

Preferences#

You can control notification categories from the app. The API stores these wallet-scoped preferences:

Preference	Default
Push enabled	On
Email enabled	Off
Web push enabled	Off
Price alerts	On
Order fills	On
Trade resolution	On
Streak reminders	On
Achievements	On
Quiet hours	Off

Quiet hours use a start time, end time, and timezone. If start and end are the same, the quiet-hours window covers the full day.

What To Expect#

Notifications are based on indexed events, so they can lag the chain.
A notification can arrive after you have already seen the state in-app.
If a device token is removed or expires, that device stops receiving pushes until it registers again.
Notification text may omit detailed amounts when privacy settings or platform display rules require a shorter message.

API Notes For Integrators#

Wallet-authenticated routes are available under /api/v1/notifications:

Route	Purpose
`POST /notifications/register`	Register a device token.
`POST /notifications/unregister`	Remove a device token.
`GET /notifications/tokens`	List registered tokens for debugging.
`GET /notifications/prefs`	Read wallet notification preferences.
`PUT /notifications/prefs`	Update wallet notification preferences.

See API Reference for authentication and response envelope details.