GET/v2/bots/{id}read scope

Get Bot

This route returns one bot with its settings, its record and its profit curve.

include adds extra sections to the response. Each include counts as a request of its own against your 120 requests a minute, so ?include=trades,activity uses 3.

include	Adds
`trades`	Adds the bot's trades, newest first. You can page them with `limit` and `cursor` and filter them with `since` and `result`.
`activity`	Adds how many trades the bot's trigger matched in the last 30 days, their middle size and the newest one. It is `null` for a market bot.

Example request

GET /v2/bots/{id}

curl "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55?include=trades%2Cactivity&limit=1" \
  -H "Authorization: Bearer rivo_live_..."

import requests

url = "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
params = [
    ("include", "trades,activity"),
    ("limit", "1"),
]

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

const params = new URLSearchParams([
  ["include", "trades,activity"],
  ["limit", "1"],
]);

const res = await fetch(`https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55?${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();

Path parameters

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

Query parameters

includestring
The extra sections to add: trades or activity. Separate them with commas, or repeat the key.
sincestring
With include=trades, returns trades opened at or after this time, in ISO 8601 with an offset.
resultstring
With include=trades, returns trades with this result: open, win or loss.
limitintegerdefault 50
Applies with include=trades. The number of rows on each page, from 1 to 200.
cursorstring
Applies with include=trades. 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": "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 }
    ],
    "trades": {
      "data": [
        {
          "market": {
            "ref": "a2Fsc2hpOm1hcmtldDpLWE1MQkdBTUUtMjZPQ1QxNDIwMDBNSUxMQUQtTUlM",
            "contract": "a2Fsc2hpOm1hcmtldDpLWE1MQkdBTUUtMjZPQ1QxNDIwMDBNSUxMQUQtTUlM",
            "title": "Milwaukee wins",
            "venue": "kalshi",
            "category": null,
            "kind": null
          },
          "outcome": "Yes",
          "contracts": 256.41,
          "entryPrice": 0.39,
          "price": 0.87,
          "profit": 123.08,
          "status": "open",
          "result": null,
          "openedAt": "2026-10-14T22:49:10.000Z",
          "closedAt": null
        }
      ],
      "nextCursor": "eyJvIjoxfQ"
    },
    "activity": {
      "trades": 241,
      "windowDays": 30,
      "medianTradeUsd": 8420.5,
      "lastTradeAt": "2026-10-15T01:58:12.000Z"
    }
  }
}

Response fields

dataobject
The bot you asked for. You can find its trade count in record.trades.
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
`VALIDATION`	A parameter is out of range or unknown, or the cursor came from another listing.
`NOT_FOUND`	No bot has that id.
`QUOTA_EXCEEDED`	The includes would take the key past its per-minute limit.

include

Adds

trades

Adds the bot's trades, newest first. You can page them with limit and cursor and filter them with since and result.

activity

Adds how many trades the bot's trigger matched in the last 30 days, their middle size and the newest one. It is null for a market bot.

Example request

GET /v2/bots/{id}

curl "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55?include=trades%2Cactivity&limit=1" \
  -H "Authorization: Bearer rivo_live_..."

import requests

url = "https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55"
headers = {
    "Authorization": "Bearer rivo_live_...",
}
params = [
    ("include", "trades,activity"),
    ("limit", "1"),
]

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

const params = new URLSearchParams([
  ["include", "trades,activity"],
  ["limit", "1"],
]);

const res = await fetch(`https://api.rivo.markets/v2/bots/signal%3A2c91e7d4-5a3b-4f08-b6e2-91d04f7a3c55?${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

includestring

The extra sections to add: trades or activity. Separate them with commas, or repeat the key.

sincestring

With include=trades, returns trades opened at or after this time, in ISO 8601 with an offset.

resultstring

With include=trades, returns trades with this result: open, win or loss.

limitintegerdefault 50

Applies with include=trades. The number of rows on each page, from 1 to 200.

cursorstring

Applies with include=trades. 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": "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 }
    ],
    "trades": {
      "data": [
        {
          "market": {
            "ref": "a2Fsc2hpOm1hcmtldDpLWE1MQkdBTUUtMjZPQ1QxNDIwMDBNSUxMQUQtTUlM",
            "contract": "a2Fsc2hpOm1hcmtldDpLWE1MQkdBTUUtMjZPQ1QxNDIwMDBNSUxMQUQtTUlM",
            "title": "Milwaukee wins",
            "venue": "kalshi",
            "category": null,
            "kind": null
          },
          "outcome": "Yes",
          "contracts": 256.41,
          "entryPrice": 0.39,
          "price": 0.87,
          "profit": 123.08,
          "status": "open",
          "result": null,
          "openedAt": "2026-10-14T22:49:10.000Z",
          "closedAt": null
        }
      ],
      "nextCursor": "eyJvIjoxfQ"
    },
    "activity": {
      "trades": 241,
      "windowDays": 30,
      "medianTradeUsd": 8420.5,
      "lastTradeAt": "2026-10-15T01:58:12.000Z"
    }
  }
}

Response fields

dataobject

The bot you asked for. You can find its trade count in record.trades.

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.

Code

When

VALIDATION

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

NOT_FOUND

No bot has that id.

QUOTA_EXCEEDED

The includes would take the key past its per-minute limit.