PATCH/v2/bots/{id}write scope

Update Bot

This route changes a paper bot. Send only the fields you want to change. Each kind of bot takes its own fields:

Kind	Takes
trader	`sizing`, `mirrorExits`, `status`, `alerts`
signal	`name`, `signal`, `sizing`, `alerts`
market	`rule`, `sizing` (`{ usd }` only), `status`, `alerts`

You cannot pause a signal bot. It records every match for as long as it exists, so delete it to stop it. Some signal bots hold settings that only the app can edit, such as sports leagues. Change those bots' signals in the app. The API refuses changes to a live bot.

Example request

PATCH /v2/bots/{id}

curl -X PATCH "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55" \
  -H "Authorization: Bearer rivo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sizing": {
    "usd": 100
  },
  "alerts": true
}'

import requests

url = "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
body = {
    "sizing": {
        "usd": 100,
    },
    "alerts": True,
}

res = requests.patch(url, headers=headers, json=body)
res.raise_for_status()
print(res.json())

const res = await fetch("https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.RIVO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "sizing": {
      "usd": 100
    },
    "alerts": true
  }),
});
if (!res.ok) throw new Error(`Rivo API ${res.status}`);
const { data } = await res.json();

Path parameters

idstringrequired
The bot's id, as List Bots returns it: trader:<id>, signal:<id> or market:<id>.

Body

namestring
A signal bot's new name, from 1 to 60 characters.
sizingobject
How much each trade stakes. Send exactly one of the two forms below.
Show 3 sizing fields
- usdnumber
  A fixed stake for each trade in USD, above 0 and up to 1,000,000.
- percentnumber
  Stakes this percentage of the source trade's dollars, above 0 and up to 10,000. Send it together with maxUsd.
- maxUsdnumber
  The most any one trade stakes when you use percent, in USD, up to 1,000,000.
signalobject
A signal bot's new signal. It replaces the old one.
Show 9 signal fields
- venuestring[]
  Matches buys on these venues: kalshi, polymarket, polymarket_us or gemini. You can pass up to 50. Leave it out to match every venue.
- categorystring[]
  Matches buys in these categories: sports, politics, crypto, finance, culture. You can pass up to 5. It matches the market's stored category, as saved signal bots do.
- minUsdnumber
  The smallest trade to match, in USD.
- maxUsdnumber
  The largest trade to match, in USD. It must be at least minUsd.
- priceMinnumber
  The lowest price paid to match, from 0 to 1.
- priceMaxnumber
  The highest price paid to match, from 0 to 1. It must be at least priceMin.
- entrystringdefault all
  Which buys to match. open matches new positions only, add matches buys that add to a position, and all matches both.
- traderstrader ref[]
  Matches only these traders' buys. Pass 1 to 25 trader refs.
- keywordsstring[]
  Matches markets whose name contains any of these words. Pass 1 to 10 words, each up to 40 characters.
ruleobject
A market bot's new rule. It replaces the old one. Set at most one of buyBelow, buyAbove, dropsBy and risesBy. If you set none, the bot buys right away.
Show 10 rule fields
- buyBelownumber
  The bot buys when the side's price falls to this level, between 0 and 1.
- buyAbovenumber
  The bot buys when the side's price rises to this level, between 0 and 1.
- dropsBynumber
  The bot buys when the price drops this far below where it stood when the bot started. Write it in dollars of price, so 0.05 is 5 points.
- risesBynumber
  The bot buys when the price rises this far above where it stood when the bot started. Write it in dollars of price.
- takeProfitnumber
  The bot sells when the price reaches this level, between 0 and 1.
- stopLossnumber
  The bot sells when the price falls to this level, between 0 and 1.
- takeProfitPointsnumber
  The bot sells when the price rises this far above the price paid. Write it in dollars of price.
- stopLossPointsnumber
  The bot sells when the price falls this far below the price paid. Write it in dollars of price.
- maxHoldHoursnumber
  The bot sells after it has held the position this many hours, up to 720.
- repeatbooleandefault false
  Set to true to buy again after each sale. When it is off, the bot trades once, or once per market when it follows a series.
mirrorExitsboolean
Set to true to make a trader bot sell when the trader sells.
statusstring
A trader or market bot's status: running or paused.
alertsboolean
Whether the bot sends in-app and Telegram messages about its trades.

Example response

Response

{
  "data": {
    "id": "signal:2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55",
    "name": "Kalshi sports buys, 30¢ to 70¢, $5,000 or more",
    "kind": "signal",
    "mode": "paper",
    "summary": "Kalshi sports buys, 30¢ to 70¢, $5,000 or more",
    "status": "running",
    "venues": ["kalshi"],
    "profit": 523.17,
    "winRate": 0.5521,
    "lastTradeAt": "2026-10-15T01:58:12.000Z",
    "settings": {
      "signal": {
        "entry": "all",
        "venue": ["kalshi"],
        "category": ["sports"],
        "minUsd": 5000,
        "priceMin": 0.3,
        "priceMax": 0.7
      },
      "sizing": { "usd": 100 },
      "alerts": true
    },
    "record": {
      "trades": 212,
      "settled": 192,
      "wins": 106,
      "losses": 86,
      "open": 20,
      "winRate": 0.5521,
      "realized": 498.6,
      "unrealized": 24.57,
      "profit": 523.17,
      "staked": 19200,
      "return": 0.026
    },
    "curve": [
      { "time": "2026-09-22T19:04:51.000Z", "profit": -100 },
      { "time": "2026-09-23T01:12:08.000Z", "profit": 21.43 }
    ]
  }
}

Response fields

dataobject
The bot after the change, with the same fields Get Bot returns.
Show 15 data fields
- idstring
  The bot's id: trader:<id>, signal:<id> or market:<id>.
- namestring
  The bot's name. A trader bot takes its trader's name, and a market bot takes the name of its market or series.
- kindstring
  The kind of bot. A trader bot copies one trader, a signal bot runs a signal, and a market bot runs a price rule on one market.
- modestring
  Whether the bot trades on paper or live. A live bot trades real money. You set it up in the app, and the API can only read it.
- summarystring
  What the bot does, in one line.
- statusstring
  The bot's status: running, paused or ended. A signal bot is never paused. It runs for as long as it exists.
- venuesstring[]
  The venues the bot trades on.
- profitnumber
  The bot's profit in USD, from both closed and open trades.
- winRatenumber or null
  The share of the bot's settled trades that won, from 0 to 1.
- lastTradeAtstring or null
  When the bot last traded, in ISO 8601 UTC.
- settingsobject
  What the bot runs. The response includes only the fields for the bot's kind.
  Show 7 settings fields
  - traderobject
    On a trader bot, the trader it copies.
    Show 2 trader fields
    reftrader ref
    The trader's ref.
    namestring or null
    The trader's public name.
  - signalobject or null
    On a signal bot, the signal, with the same fields Backtest takes. It is null when the bot holds settings that only the app can edit.
  - marketobject
    On a market bot, the contract and side it watches.
    Show 4 market fields
    refmarket ref
    The contract's ref.
    titlestring
    The contract's title.
    outcomestring
    The side the bot trades: Yes or No.
    seriesboolean
    Whether the bot follows the repeating series.
  - ruleobject
    On a market bot, the rule, with the same fields POST /v2/bots takes.
  - sizingobject or null
    How much each trade stakes: { usd } or { percent, maxUsd }.
  - mirrorExitsboolean
    On a trader bot, whether it sells when the trader sells.
  - alertsboolean
    Whether the bot sends in-app and Telegram messages.
- recordobject
  The bot's record.
  Show 11 record fields
  - tradesinteger
    The number of trades the bot took.
  - settledinteger
    The number of trades that settled or closed.
  - winsinteger
    The number of wins.
  - lossesinteger
    The number of losses.
  - openinteger
    The number of trades still open.
  - winRatenumber or null
    The share of settled trades that won, from 0 to 1.
  - realizednumber
    The profit from closed trades, in USD.
  - unrealizednumber
    The profit on open trades, in USD.
  - profitnumber
    The closed and open profit added together, in USD.
  - stakednumber
    The dollars the bot staked.
  - returnnumber or null
    The profit divided by the dollars staked.
- curveobject[]
  The running total of closed profit, one point for each trade.
  Show 2 curve fields
  - timestring
    The time of this point, in ISO 8601 UTC.
  - profitnumber
    The total profit up to this point, in USD.
- tradesobject
  One page of the bot's trades, newest first, when you ask for include=trades.
  Show 2 trades fields
  - dataobject[]
    The trades on this page.
    Show 10 data fields
    marketobject or null
    The market the trade is on. Here category and kind are always null.
    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 bot bought.
    contractsnumber
    The number of contracts bought.
    entryPricenumber
    The price paid, from 0 to 1.
    pricenumber
    The price now while the trade is open. Once it closes, this is the exit price or the payout.
    profitnumber
    The profit in USD.
    statusstring
    Whether the trade is open or closed.
    resultstring or null
    The result once the trade closes: win, loss or void.
    openedAtstring
    When the trade opened, in ISO 8601 UTC.
    closedAtstring or null
    When the trade closed, in ISO 8601 UTC.
  - nextCursorstring or null
    Pass this as cursor to read the next page. It is null on the last page.
- activityobject or null
  How busy the bot's trigger has been, when you ask for include=activity. It is null for a market bot.
  Show 4 activity fields
  - tradesinteger
    The number of trades the trigger matched in the window.
  - windowDaysinteger
    The length of the window in days, which is 30.
  - medianTradeUsdnumber or null
    The middle trade size, in USD.
  - lastTradeAtstring or null
    When the newest matching trade happened, in ISO 8601 UTC.

Errors

Code	When
`SCOPE_REQUIRED`	The key does not have the `write` scope.
`NOT_FOUND`	No bot has that id.
`VALIDATION`	The body is empty, or a field is unknown or does not fit this kind of bot. You sent `status` to a signal bot, or a market bot's `sizing` is not `{ usd }`. The bot holds a signal that only the app can edit, or the bot is live.

Kind

Takes

trader

sizing, mirrorExits, status, alerts

signal

name, signal, sizing, alerts

market

rule, sizing ({ usd } only), status, alerts

Example request

PATCH /v2/bots/{id}

curl -X PATCH "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55" \
  -H "Authorization: Bearer rivo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sizing": {
    "usd": 100
  },
  "alerts": true
}'

import requests

url = "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
body = {
    "sizing": {
        "usd": 100,
    },
    "alerts": True,
}

res = requests.patch(url, headers=headers, json=body)
res.raise_for_status()
print(res.json())

const res = await fetch("https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.RIVO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "sizing": {
      "usd": 100
    },
    "alerts": true
  }),
});
if (!res.ok) throw new Error(`Rivo API ${res.status}`);
const { data } = await res.json();

Body

namestring

A signal bot's new name, from 1 to 60 characters.

sizingobject

How much each trade stakes. Send exactly one of the two forms below.

Show 3 sizing fields

usdnumber
A fixed stake for each trade in USD, above 0 and up to 1,000,000.
percentnumber
Stakes this percentage of the source trade's dollars, above 0 and up to 10,000. Send it together with maxUsd.
maxUsdnumber
The most any one trade stakes when you use percent, in USD, up to 1,000,000.

signalobject

A signal bot's new signal. It replaces the old one.

Show 9 signal fields

venuestring[]
Matches buys on these venues: kalshi, polymarket, polymarket_us or gemini. You can pass up to 50. Leave it out to match every venue.
categorystring[]
Matches buys in these categories: sports, politics, crypto, finance, culture. You can pass up to 5. It matches the market's stored category, as saved signal bots do.
minUsdnumber
The smallest trade to match, in USD.
maxUsdnumber
The largest trade to match, in USD. It must be at least minUsd.
priceMinnumber
The lowest price paid to match, from 0 to 1.
priceMaxnumber
The highest price paid to match, from 0 to 1. It must be at least priceMin.
entrystringdefault all
Which buys to match. open matches new positions only, add matches buys that add to a position, and all matches both.
traderstrader ref[]
Matches only these traders' buys. Pass 1 to 25 trader refs.
keywordsstring[]
Matches markets whose name contains any of these words. Pass 1 to 10 words, each up to 40 characters.

ruleobject

A market bot's new rule. It replaces the old one. Set at most one of buyBelow, buyAbove, dropsBy and risesBy. If you set none, the bot buys right away.

Show 10 rule fields

buyBelownumber
The bot buys when the side's price falls to this level, between 0 and 1.
buyAbovenumber
The bot buys when the side's price rises to this level, between 0 and 1.
dropsBynumber
The bot buys when the price drops this far below where it stood when the bot started. Write it in dollars of price, so 0.05 is 5 points.
risesBynumber
The bot buys when the price rises this far above where it stood when the bot started. Write it in dollars of price.
takeProfitnumber
The bot sells when the price reaches this level, between 0 and 1.
stopLossnumber
The bot sells when the price falls to this level, between 0 and 1.
takeProfitPointsnumber
The bot sells when the price rises this far above the price paid. Write it in dollars of price.
stopLossPointsnumber
The bot sells when the price falls this far below the price paid. Write it in dollars of price.
maxHoldHoursnumber
The bot sells after it has held the position this many hours, up to 720.
repeatbooleandefault false
Set to true to buy again after each sale. When it is off, the bot trades once, or once per market when it follows a series.

mirrorExitsboolean

Set to true to make a trader bot sell when the trader sells.

statusstring

A trader or market bot's status: running or paused.

alertsboolean

Whether the bot sends in-app and Telegram messages about its trades.

Example response

Response

{
  "data": {
    "id": "signal:2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55",
    "name": "Kalshi sports buys, 30¢ to 70¢, $5,000 or more",
    "kind": "signal",
    "mode": "paper",
    "summary": "Kalshi sports buys, 30¢ to 70¢, $5,000 or more",
    "status": "running",
    "venues": ["kalshi"],
    "profit": 523.17,
    "winRate": 0.5521,
    "lastTradeAt": "2026-10-15T01:58:12.000Z",
    "settings": {
      "signal": {
        "entry": "all",
        "venue": ["kalshi"],
        "category": ["sports"],
        "minUsd": 5000,
        "priceMin": 0.3,
        "priceMax": 0.7
      },
      "sizing": { "usd": 100 },
      "alerts": true
    },
    "record": {
      "trades": 212,
      "settled": 192,
      "wins": 106,
      "losses": 86,
      "open": 20,
      "winRate": 0.5521,
      "realized": 498.6,
      "unrealized": 24.57,
      "profit": 523.17,
      "staked": 19200,
      "return": 0.026
    },
    "curve": [
      { "time": "2026-09-22T19:04:51.000Z", "profit": -100 },
      { "time": "2026-09-23T01:12:08.000Z", "profit": 21.43 }
    ]
  }
}

Response fields

dataobject

The bot after the change, with the same fields Get Bot returns.

Show 15 data fields

idstring
The bot's id: trader:<id>, signal:<id> or market:<id>.
namestring
The bot's name. A trader bot takes its trader's name, and a market bot takes the name of its market or series.
kindstring
The kind of bot. A trader bot copies one trader, a signal bot runs a signal, and a market bot runs a price rule on one market.
modestring
Whether the bot trades on paper or live. A live bot trades real money. You set it up in the app, and the API can only read it.
summarystring
What the bot does, in one line.
statusstring
The bot's status: running, paused or ended. A signal bot is never paused. It runs for as long as it exists.
venuesstring[]
The venues the bot trades on.
profitnumber
The bot's profit in USD, from both closed and open trades.
winRatenumber or null
The share of the bot's settled trades that won, from 0 to 1.
lastTradeAtstring or null
When the bot last traded, in ISO 8601 UTC.
settingsobject
What the bot runs. The response includes only the fields for the bot's kind.
Show 7 settings fields
- traderobject
  On a trader bot, the trader it copies.
  Show 2 trader fields
  - reftrader ref
    The trader's ref.
  - namestring or null
    The trader's public name.
- signalobject or null
  On a signal bot, the signal, with the same fields Backtest takes. It is null when the bot holds settings that only the app can edit.
- marketobject
  On a market bot, the contract and side it watches.
  Show 4 market fields
  - refmarket ref
    The contract's ref.
  - titlestring
    The contract's title.
  - outcomestring
    The side the bot trades: Yes or No.
  - seriesboolean
    Whether the bot follows the repeating series.
- ruleobject
  On a market bot, the rule, with the same fields POST /v2/bots takes.
- sizingobject or null
  How much each trade stakes: { usd } or { percent, maxUsd }.
- mirrorExitsboolean
  On a trader bot, whether it sells when the trader sells.
- alertsboolean
  Whether the bot sends in-app and Telegram messages.
recordobject
The bot's record.
Show 11 record fields
- tradesinteger
  The number of trades the bot took.
- settledinteger
  The number of trades that settled or closed.
- winsinteger
  The number of wins.
- lossesinteger
  The number of losses.
- openinteger
  The number of trades still open.
- winRatenumber or null
  The share of settled trades that won, from 0 to 1.
- realizednumber
  The profit from closed trades, in USD.
- unrealizednumber
  The profit on open trades, in USD.
- profitnumber
  The closed and open profit added together, in USD.
- stakednumber
  The dollars the bot staked.
- returnnumber or null
  The profit divided by the dollars staked.
curveobject[]
The running total of closed profit, one point for each trade.
Show 2 curve fields
- timestring
  The time of this point, in ISO 8601 UTC.
- profitnumber
  The total profit up to this point, in USD.
tradesobject
One page of the bot's trades, newest first, when you ask for include=trades.
Show 2 trades fields
- dataobject[]
  The trades on this page.
  Show 10 data fields
  - marketobject or null
    The market the trade is on. Here category and kind are always null.
    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 bot bought.
  - contractsnumber
    The number of contracts bought.
  - entryPricenumber
    The price paid, from 0 to 1.
  - pricenumber
    The price now while the trade is open. Once it closes, this is the exit price or the payout.
  - profitnumber
    The profit in USD.
  - statusstring
    Whether the trade is open or closed.
  - resultstring or null
    The result once the trade closes: win, loss or void.
  - openedAtstring
    When the trade opened, in ISO 8601 UTC.
  - closedAtstring or null
    When the trade closed, in ISO 8601 UTC.
- nextCursorstring or null
  Pass this as cursor to read the next page. It is null on the last page.
activityobject or null
How busy the bot's trigger has been, when you ask for include=activity. It is null for a market bot.
Show 4 activity fields
- tradesinteger
  The number of trades the trigger matched in the window.
- windowDaysinteger
  The length of the window in days, which is 30.
- medianTradeUsdnumber or null
  The middle trade size, in USD.
- lastTradeAtstring or null
  When the newest matching trade happened, in ISO 8601 UTC.

Errors

Code	When
`SCOPE_REQUIRED`	The key does not have the `write` scope.
`NOT_FOUND`	No bot has that id.
`VALIDATION`	The body is empty, or a field is unknown or does not fit this kind of bot. You sent `status` to a signal bot, or a market bot's `sizing` is not `{ usd }`. The bot holds a signal that only the app can edit, or the bot is live.