Read the inbox and mark it read

GET returns the signed-in account’s notifications (newest first, up to 50) and the current unread count in one response. POST marks every unread notification read, takes no body, and returns {"ok":true} — after it runs, unread on the next GET is 0. Notifications come from price alerts firing, Autopilot runs, and completed trades.

GET, POST /api/notifications · requires a Privy bearer token, 401 without one. Base URL, rate limits, and error shapes: conventions.

Returns (GET)

Field	Type	Description
notifications	array	Up to 50 notifications, newest first.
unread	number	Count of notifications with readAt still null.

Each notification:

Field	Type	Description
id	number	Stable id.
kind	"alert" | "autopilot" | "trade" | "system"	What produced it.
title	string	One-line summary.
body	string | undefined	Optional detail line.
symbol	string | undefined	The related ticker, when there is one.
txHash	string | undefined	The settling transaction hash, when there is one.
createdAt	number	Unix seconds when created.
readAt	number | undefined	Unix seconds when marked read, absent while unread.

Example

# read the inbox
curl https://monvera.best/api/notifications \
  -H "Authorization: Bearer $MONVERA_TOKEN"

# mark everything read
curl -X POST https://monvera.best/api/notifications \
  -H "Authorization: Bearer $MONVERA_TOKEN"

{
  "notifications": [
    {
      "id": 1807,
      "kind": "autopilot",
      "title": "Autopilot invested $25.00",
      "body": "Vera placed your scheduled plan. Tap to see the run.",
      "txHash": "0x…",
      "createdAt": 1751884800,
      "readAt": null
    },
    {
      "id": 1806,
      "kind": "alert",
      "title": "NVDA fell below $120",
      "symbol": "NVDA",
      "createdAt": 1751880000,
      "readAt": 1751881000
    }
  ],
  "unread": 1
}

Notes

txHash is the checkable end of an autopilot or trade notification: it names the exact transaction on Robinhood Chain (4663) that settled it. Open it at https://robinhoodchain.blockscout.com/tx/<txHash>. Neither method is rate limited. See also alerts and autopilot.