Alert inbox
MCP tool: get_alerts
Keyset paged. Pass the nextCursor from one response as before on the next call.
Query parameters
limitnumberdefault: 501 to 200.
beforestringISO 8601 timestamp, taken from a previous response's nextCursor.
Response
nextCursor is null on the last page. Strategy rollups carry strategyId and no followedWalletName; follow alerts carry the reverse.
curl "https://api.rivo.markets/v1/alerts?limit=25" \
-H "Authorization: Bearer rivo_live_..."import requests
r = requests.get(
"https://api.rivo.markets/v1/alerts",
headers={"Authorization": "Bearer rivo_live_..."},
params={
"limit": 25,
},
)
print(r.json()["data"])const res = await fetch("https://api.rivo.markets/v1/alerts?limit=25", {
headers: { Authorization: "Bearer rivo_live_..." },
});
const { data } = await res.json();response
{
"success": true,
"data": {
"items": [
{
"id": "c4d1...9e07",
"whaleEventId": "b4a4...1c77",
"headline": "coldbrew bought YES on the Fed cut",
"reasoning": "A trader you follow opened a new position.",
"marketTitle": "Will the Fed cut in September?",
"marketCategory": "finance",
"channelsDelivered": ["inapp", "telegram"],
"strategyId": null,
"followedWalletName": "coldbrew",
"readAt": null,
"createdAt": "2026-08-13T07:58:03.000Z"
}
],
"nextCursor": "2026-08-13T07:58:03.000Z"
}
}