Live feed
MCP tool: get_live_feed
Lane whale is large trades regardless of who placed them. Lane tracked is any trade by an identified trader regardless of size. One trade can appear on both.
Every event carries priorSameSideCount and priorOppositeSideCount: how many other tracked traders took the same or the opposite side of that market in the last 24 hours. That is the consensus signal, and it is the fastest way to see whether a trade is contrarian or crowded.
Each event also carries a marketRef, the opaque handle the market endpoint takes.
Paged with a cursor. Pass nextCursor from one response as cursor on the next.
Query parameters
lanestringdefault: whale"whale" or "tracked".
platformstring"polymarket" or "kalshi".
categorystringMarket category.
minAmountUsdnumberMinimum trade size in USD.
priceMinnumberMinimum entry price, 0 to 1.
priceMaxnumberMaximum entry price, 0 to 1.
pageSizenumberdefault: 251 to 100.
cursorstringFrom a previous response's nextCursor.
Response
The default lane excludes trims and closes, since those are exits and never settle. Lane tracked includes any size, so amounts there are often small.
curl "https://api.rivo.markets/v1/feed?lane=tracked&pageSize=25" \
-H "Authorization: Bearer rivo_live_..."import requests
r = requests.get(
"https://api.rivo.markets/v1/feed",
headers={"Authorization": "Bearer rivo_live_..."},
params={
"lane": "tracked",
"pageSize": 25,
},
)
print(r.json()["data"])const res = await fetch("https://api.rivo.markets/v1/feed?lane=tracked&pageSize=25", {
headers: { Authorization: "Bearer rivo_live_..." },
});
const { data } = await res.json();{
"success": true,
"data": {
"data": [
{
"id": "b4a4...1c77",
"platform": "polymarket",
"marketTitle": "Will the Fed cut in September?",
"marketCategory": "finance",
"outcomeName": "YES",
"direction": "buy_yes",
"amount": 24500,
"price": 0.62,
"positionDelta": "open",
"traderName": "coldbrew",
"priorSameSideCount": 3,
"priorOppositeSideCount": 0,
"priorSameSideAmount": 91200,
"priorOppositeSideAmount": 0,
"marketRef": "cG9seW1hcmtldDptYXJrZXQ6MHhhYmM",
"detectedAt": "2026-08-13T07:58:03.000Z"
}
],
"total": 1284,
"pageSize": 25,
"hasMore": true,
"nextCursor": "eyJhdCI6MTc1NTA3MTg4MzAwMCwiaWQiOiJiNGE0In0"
}
}