GET/v2/movesread scope

List Moves

This route returns market moves from the last 24 hours, newest first. There are three types:

move means the Yes price moved sharply within a few minutes and held there.
flip means the favorite changed.
whales means several different whales bought one side within a few minutes.

Moves do not count toward the daily trade allowance.

Example request

GET /v2/moves

curl "https://api.rivo.markets/v2/moves?category=crypto&minPoints=10&limit=2" \
  -H "Authorization: Bearer rivo_live_..."

import requests

url = "https://api.rivo.markets/v2/moves"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
params = [
    ("category", "crypto"),
    ("minPoints", "10"),
    ("limit", "2"),
]

res = requests.get(url, headers=headers, params=params)
res.raise_for_status()
print(res.json())

const params = new URLSearchParams([
  ["category", "crypto"],
  ["minPoints", "10"],
  ["limit", "2"],
]);

const res = await fetch(`https://api.rivo.markets/v2/moves?${params}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.RIVO_API_KEY}`,
  },
});
if (!res.ok) throw new Error(`Rivo API ${res.status}`);
const { data } = await res.json();

Query parameters

venuestring
Returns rows from these venues: kalshi, polymarket, polymarket_us or gemini. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.
categorystring
Returns rows in these categories: sports, politics, crypto, finance, culture. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.
kindstring
Returns rows in these kinds of market. Each kind belongs to one category: nfl, college_football, nba, wnba, college_basketball, basketball, mlb, nhl, soccer, tennis, golf, mma, boxing, motorsport, cricket, esports, chess, rugby, olympics, parlay, other_sports, us_elections, us_politics, world_politics, other_politics, bitcoin, ethereum, solana, xrp, other_crypto, fed_rates, economic_data, stocks_indices, companies, commodities, fx, other_finance, mentions, weather, entertainment, tech_ai, health, other_culture. See Kinds of market. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.
marketmarket ref
Returns rows for this market. The ref can name one contract or a market with several outcomes. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.
typestring
Returns moves of these types: move, flip or whales. Repeat the key to pass several.
minPointsnumber
Returns move rows whose price changed by at least this many points, from 0 to 100. Flips and whales have no price change, so they always pass.
priceMinnumber
Returns moves where the Yes price ended at or above this, from 0 to 1. Use it to leave out markets that are all but decided.
priceMaxnumber
Returns moves where the Yes price ended at or below this, from 0 to 1.
qstring
Returns moves on markets whose name contains every one of these words, up to 200 characters.
sincestring
Returns moves at or after this time, in ISO 8601 with an offset.
limitintegerdefault 50
The number of rows on each page, from 1 to 200.
cursorstring
Pass the nextCursor from the previous page to read the next one. A cursor works only on the listing that made it. See Paging.

Example response

Response

{
  "data": [
    {
      "id": "flip:kalshi:market:KXBTCD-26OCT1423-T80799.99:1792031312711",
      "time": "2026-10-15T02:28:32.711Z",
      "type": "flip",
      "market": {
        "ref": "a2Fsc2hpOm1hcmtldDpLWEJUQ0QtMjZPQ1QxNDIzLVQ4MDc5OS45OQ",
        "contract": "a2Fsc2hpOm1hcmtldDpLWEJUQ0QtMjZPQ1QxNDIzLVQ4MDc5OS45OQ",
        "title": "Bitcoin price on Oct 14, 2026?",
        "venue": "kalshi",
        "category": "crypto",
        "kind": "bitcoin"
      },
      "outcome": "No",
      "priceBefore": null,
      "priceAfter": 0.36,
      "minutes": null,
      "traders": null,
      "usd": null
    },
    {
      "id": "price_move:polymarket:market:btc-updown-5m-1792031100:1792031230000",
      "time": "2026-10-15T02:27:10.000Z",
      "type": "move",
      "market": {
        "ref": "cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAw",
        "contract": "cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAw",
        "title": "Bitcoin Up or Down - October 14, 10:25PM-10:30PM ET",
        "venue": "polymarket",
        "category": "crypto",
        "kind": "bitcoin"
      },
      "outcome": "Yes",
      "priceBefore": 0.5,
      "priceAfter": 0.89,
      "minutes": 5,
      "traders": null,
      "usd": null
    }
  ],
  "nextCursor": "eyJ0IjoxNzkyMDMxMjMwMDAwLCJpZCI6InByaWNlX21vdmU6cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAwOjE3OTIwMzEyMzAwMDAifQ"
}

Response fields

dataobject[]
The moves on this page.
Show 10 data fields
- idstring
  The move's id. It never changes, so the listing and the stream use the same id.
- timestring
  When Rivo recorded the move, in ISO 8601 UTC.
- typestring
  What happened. move means the Yes price moved sharply. flip means the favorite changed. whales means several whales bought one side within minutes.
- marketobject
  The market this row is about.
  Show 6 market fields
  - refmarket ref
    The market's ref. You can pass it to any market filter or to Get Market. On a market of several outcomes, it names the whole event.
  - contractmarket ref or null
    The ref of the exact contract. It is the same as ref on a market with one contract. On a market of several outcomes, such as a game with a moneyline and a spread, it tells the contracts apart. Pass it to Place Paper Order or a market bot.
  - titlestring
    The market's title, as the venue writes it.
  - venuestring
    The venue that lists the market: one of kalshi, polymarket, polymarket_us or gemini.
  - categorystring or null
    The market's category: one of sports, politics, crypto, finance, culture. It is null when Rivo has not classified the market.
  - kindstring or null
    The kind of market, such as nfl or bitcoin. It is null when Rivo has not classified the market yet.
- outcomestring
  The side the move is about. On a move it is Yes, the side whose price moved. On a flip it is the new favorite. On whales it is the side the whales bought.
- priceBeforenumber or null
  On a move, the Yes price before the move. On other types it is null.
- priceAfternumber or null
  The Yes price when Rivo recorded the move. It is null on a whales move when Rivo has no price yet.
- minutesinteger or null
  On a move, the number of minutes the move took. On other types it is null.
- tradersinteger or null
  On whales, the number of whales who bought. On other types it is null.
- usdnumber or null
  On whales, the dollars those whales spent between them. On other types it is null.
nextCursorstring or null
Pass this as cursor to read the next page. It is null on the last page.

Errors

Code	When
`VALIDATION`	A parameter is out of range or unknown, or the cursor came from another listing.

Example request

GET /v2/moves

curl "https://api.rivo.markets/v2/moves?category=crypto&minPoints=10&limit=2" \
  -H "Authorization: Bearer rivo_live_..."

import requests

url = "https://api.rivo.markets/v2/moves"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
params = [
    ("category", "crypto"),
    ("minPoints", "10"),
    ("limit", "2"),
]

res = requests.get(url, headers=headers, params=params)
res.raise_for_status()
print(res.json())

const params = new URLSearchParams([
  ["category", "crypto"],
  ["minPoints", "10"],
  ["limit", "2"],
]);

const res = await fetch(`https://api.rivo.markets/v2/moves?${params}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.RIVO_API_KEY}`,
  },
});
if (!res.ok) throw new Error(`Rivo API ${res.status}`);
const { data } = await res.json();

Query parameters

venuestring

Returns rows from these venues: kalshi, polymarket, polymarket_us or gemini. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.

categorystring

Returns rows in these categories: sports, politics, crypto, finance, culture. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.

kindstring

Returns rows in these kinds of market. Each kind belongs to one category: nfl, college_football, nba, wnba, college_basketball, basketball, mlb, nhl, soccer, tennis, golf, mma, boxing, motorsport, cricket, esports, chess, rugby, olympics, parlay, other_sports, us_elections, us_politics, world_politics, other_politics, bitcoin, ethereum, solana, xrp, other_crypto, fed_rates, economic_data, stocks_indices, companies, commodities, fx, other_finance, mentions, weather, entertainment, tech_ai, health, other_culture. See Kinds of market. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.

marketmarket ref

Returns rows for this market. The ref can name one contract or a market with several outcomes. To pass several values, repeat the key, up to 50 times. A row matches if it matches any of them.

typestring

Returns moves of these types: move, flip or whales. Repeat the key to pass several.

minPointsnumber

Returns move rows whose price changed by at least this many points, from 0 to 100. Flips and whales have no price change, so they always pass.

priceMinnumber

Returns moves where the Yes price ended at or above this, from 0 to 1. Use it to leave out markets that are all but decided.

priceMaxnumber

Returns moves where the Yes price ended at or below this, from 0 to 1.

qstring

Returns moves on markets whose name contains every one of these words, up to 200 characters.

sincestring

Returns moves at or after this time, in ISO 8601 with an offset.

limitintegerdefault 50

The number of rows on each page, from 1 to 200.

cursorstring

Pass the nextCursor from the previous page to read the next one. A cursor works only on the listing that made it. See Paging.

Example response

Response

{
  "data": [
    {
      "id": "flip:kalshi:market:KXBTCD-26OCT1423-T80799.99:1792031312711",
      "time": "2026-10-15T02:28:32.711Z",
      "type": "flip",
      "market": {
        "ref": "a2Fsc2hpOm1hcmtldDpLWEJUQ0QtMjZPQ1QxNDIzLVQ4MDc5OS45OQ",
        "contract": "a2Fsc2hpOm1hcmtldDpLWEJUQ0QtMjZPQ1QxNDIzLVQ4MDc5OS45OQ",
        "title": "Bitcoin price on Oct 14, 2026?",
        "venue": "kalshi",
        "category": "crypto",
        "kind": "bitcoin"
      },
      "outcome": "No",
      "priceBefore": null,
      "priceAfter": 0.36,
      "minutes": null,
      "traders": null,
      "usd": null
    },
    {
      "id": "price_move:polymarket:market:btc-updown-5m-1792031100:1792031230000",
      "time": "2026-10-15T02:27:10.000Z",
      "type": "move",
      "market": {
        "ref": "cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAw",
        "contract": "cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAw",
        "title": "Bitcoin Up or Down - October 14, 10:25PM-10:30PM ET",
        "venue": "polymarket",
        "category": "crypto",
        "kind": "bitcoin"
      },
      "outcome": "Yes",
      "priceBefore": 0.5,
      "priceAfter": 0.89,
      "minutes": 5,
      "traders": null,
      "usd": null
    }
  ],
  "nextCursor": "eyJ0IjoxNzkyMDMxMjMwMDAwLCJpZCI6InByaWNlX21vdmU6cG9seW1hcmtldDptYXJrZXQ6YnRjLXVwZG93bi01bS0xNzkyMDMxMTAwOjE3OTIwMzEyMzAwMDAifQ"
}

Response fields

dataobject[]

The moves on this page.

Show 10 data fields

idstring
The move's id. It never changes, so the listing and the stream use the same id.
timestring
When Rivo recorded the move, in ISO 8601 UTC.
typestring
What happened. move means the Yes price moved sharply. flip means the favorite changed. whales means several whales bought one side within minutes.
marketobject
The market this row is about.
Show 6 market fields
- refmarket ref
  The market's ref. You can pass it to any market filter or to Get Market. On a market of several outcomes, it names the whole event.
- contractmarket ref or null
  The ref of the exact contract. It is the same as ref on a market with one contract. On a market of several outcomes, such as a game with a moneyline and a spread, it tells the contracts apart. Pass it to Place Paper Order or a market bot.
- titlestring
  The market's title, as the venue writes it.
- venuestring
  The venue that lists the market: one of kalshi, polymarket, polymarket_us or gemini.
- categorystring or null
  The market's category: one of sports, politics, crypto, finance, culture. It is null when Rivo has not classified the market.
- kindstring or null
  The kind of market, such as nfl or bitcoin. It is null when Rivo has not classified the market yet.
outcomestring
The side the move is about. On a move it is Yes, the side whose price moved. On a flip it is the new favorite. On whales it is the side the whales bought.
priceBeforenumber or null
On a move, the Yes price before the move. On other types it is null.
priceAfternumber or null
The Yes price when Rivo recorded the move. It is null on a whales move when Rivo has no price yet.
minutesinteger or null
On a move, the number of minutes the move took. On other types it is null.
tradersinteger or null
On whales, the number of whales who bought. On other types it is null.
usdnumber or null
On whales, the dollars those whales spent between them. On other types it is null.

nextCursorstring or null

Pass this as cursor to read the next page. It is null on the last page.

Code

When

VALIDATION

A parameter is out of range or unknown, or the cursor came from another listing.