GET/v1/markets/search
Search markets
MCP tool: search_markets
Matches against markets with recent whale activity, so a hit tells you both that the market exists and that big money has touched it lately. Each result carries the trades behind it, grouped by side.
Query parameters
qstringrequiredPart of the market name. At least 2 characters.
Response
events is the raw whale trades behind the market, most recent first, truncated here to one.
curl "https://api.rivo.markets/v1/markets/search?q=world+cup" \
-H "Authorization: Bearer rivo_live_..."import requests
r = requests.get(
"https://api.rivo.markets/v1/markets/search",
headers={"Authorization": "Bearer rivo_live_..."},
params={
"q": "world cup",
},
)
print(r.json()["data"])const res = await fetch("https://api.rivo.markets/v1/markets/search?q=world+cup", {
headers: { Authorization: "Bearer rivo_live_..." },
});
const { data } = await res.json();response
{
"success": true,
"data": {
"query": "world cup",
"windowHours": 24,
"results": [
{
"marketKey": "polymarket:0x53c9...",
"platform": "polymarket",
"platformMarketId": "0x53c9...",
"marketTitle": "Will Argentina win the 2026 FIFA World Cup?",
"marketCategory": "sports",
"latestAt": 1755071883000,
"totalAmount": 412000,
"whaleCount": 21,
"sides": [
{ "key": "buy_yes", "label": "YES", "amount": 382400, "whaleCount": 18, "bullish": true }
],
"events": [
{
"id": "pm-1f4a...",
"platform": "polymarket",
"marketTitle": "Will Argentina win the 2026 FIFA World Cup?",
"direction": "buy_yes",
"outcomeName": "Yes",
"amount": 240000,
"price": 0.42,
"positionDelta": "add",
"detectedAt": 1755071883000
}
]
}
]
}
}