Download Bot Trades
This route returns a CSV file, not JSON. It has one row for every trader trade the bot decided on, oldest first. Each row shows whether the bot copied the trade, skipped it and why, or sent an order that did not fill. It also shows the trader's fill and their whole order, the bot's limit, fill, shares and fee, and how the market settled. A live buy also shows when its order was sent, how long it worked, and the order book it went into. For a trader bot, the file adds every sale the trader made in a market the bot bought. You see their exits even when the bot holds to settlement.
It is the same file as the Download trades button in the app, and the MCP tool get_bot_audit returns it too (the last 7 days unless days is given). Paper and live rows are marked in mode. One download counts as one trade listing toward your account's daily trades.
A market bot's file has different columns. Each row is one trade: mode, market_id, market, side, bought_at_utc, buy_price_wanted, buy_price_filled, contracts, cost_usd, sold_at_utc, sell_price_wanted, sell_price_filled, why_it_closed, high_while_held, low_while_held, fees_usd and pnl_usd. The wanted prices show what the bot asked for beside what it got.
Example request
curl "https://api.rivo.markets/v2/bots/trader%3A7f3a2b10-4c1d-4e8a-9b2f-3d6e5a1c0b77/audit.csv?days=30" \
-H "Authorization: Bearer rivo_live_..."import requests
url = "https://api.rivo.markets/v2/bots/trader%3A7f3a2b10-4c1d-4e8a-9b2f-3d6e5a1c0b77/audit.csv"
headers = {
"Authorization": "Bearer rivo_live_...",
}
params = [
("days", "30"),
]
res = requests.get(url, headers=headers, params=params)
res.raise_for_status()
print(res.json())const params = new URLSearchParams([
["days", "30"],
]);
const res = await fetch(`https://api.rivo.markets/v2/bots/trader%3A7f3a2b10-4c1d-4e8a-9b2f-3d6e5a1c0b77/audit.csv?${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
idstringrequiredThe bot's id, as List Bots returns it:
trader:<id>,signal:<id>ormarket:<id>.
Query parameters
daysintegerdefault90How far back to reach, from 1 to 365 days.
Example response
row,bot_decided_at_utc,trader_traded_at_utc,seconds_after_trader,venue,market_id,market,outcome,trader,trader_action,trader_fill_price,trader_fill_shares,trader_fill_usd,trader_order_usd,trader_order_avg_price,trader_order_low_price,trader_order_high_price,mode,bot_action,bot_status,skip_reason,trades_skipped,detail,bot_requested_usd,bot_limit_price,order_sent_at_utc,order_seconds_working,book_read_at_utc,book_best_ask,book_contracts_at_or_under_limit,book_usd_at_or_under_limit,book_asks,venue_trades_while_working,lowest_price_traded_while_working,highest_price_traded_while_working,contracts_traded_at_or_under_limit,bot_fill_price,bot_shares,bot_fee_usd,bot_cost_usd,bot_proceeds_usd,market_result_for_outcome,rule_saved_at_utc,rule
bot decision,2026-11-12T21:36:05.293Z,2026-11-12T21:36:04.174Z,1.1,kalshi,KXEXAMPLE-170,Over 169.5 points scored,YES,example.trader,buy_yes,0.68,10,6.8,245.23,0.6751,0.66,0.68,live,BUY,filled,,,,1,0.7,2026-11-12T21:36:05.341Z,0.4,2026-11-12T21:36:05.290Z,0.69,25,17.35,69c x 10; 70c x 15; 74c x 110,,,,,0.69,1,0.02,0.71,,lost,,
bot decision,2026-11-12T21:36:41.398Z,2026-11-12T21:36:39.895Z,1.5,kalshi,KXEXAMPLE-170,Over 169.5 points scored,NO,example.trader,buy_no,0.1,77.29,7.73,7.73,0.1,0.1,0.1,live,,skipped_copy_price,copy_price,1,,,,,,,,,,,,,,,,,,,,won,,
trader sale,,2026-11-12T21:37:52.885Z,,kalshi,KXEXAMPLE-170,Over 169.5 points scored,Yes,example.trader,sell_yes,0.17,290.02,51.32,51.32,0.17,0.16,0.2,,,,,,,,,,,,,,,,,,,,,,,,,lost,,Response fields
rowstringbot decisionfor a trade the bot decided on,trader salefor a sale by the trader in a market the bot bought.bot_decided_at_utc / trader_traded_at_utc / seconds_after_traderstring / string / numberWhen the bot decided, when the trader traded, and the gap in seconds.
trader_fill_* / trader_order_*numberThe trader's fill the bot saw, and their whole order at that moment: its dollars, average, lowest and highest price.
modestringpaperorlive.bot_action / bot_status / skip_reason / detailstringWhat the bot did:
BUYorSELLand the order's status, or the skip and why.bot_limit_price / bot_fill_price / bot_shares / bot_fee_usdnumberThe bot's order: its price limit, average fill, shares filled and the venue's fee.
order_sent_at_utc / order_seconds_workingstring / numberWhen the live order reached the venue, and how long it worked before it filled, expired or was canceled. A Kalshi copy rests at its limit about a minute and is not sent again.
book_read_at_utc / book_best_ask / book_contracts_at_or_under_limit / book_usd_at_or_under_limit / book_asksstring / number / number / number / stringThe order book the live order was sized from: when it was read, the cheapest ask (
none offeredwhen nobody was selling), the contracts offered at or under the bot's limit and what they cost, and up to 10 ask levels, as69c x 10; 70c x 15. Live buys from November 15, 2026 on; empty on earlier rows, paper rows and sales.venue_trades_while_working / lowest_price_traded_while_working / highest_price_traded_while_working / contracts_traded_at_or_under_limitnumberFor a live Kalshi buy that filled nothing: what traded on its side while its order worked, from Kalshi's public trade feed. Any trade at or under the limit would have matched the order first, so 0 contracts there means no seller met the limit. Read a few minutes after the order ends, for the last 30 days.
bot_cost_usd / bot_proceeds_usdnumberWhat a buy cost with its fee, or what a sale brought in after its fee.
market_result_for_outcomestringwon,lost, oropenfor the row's outcome.source_trade_idstringThe trader's trade the row is about. Every copy and skip of one trade carries the same id, paper or live and in any of your bots, so files join on it.
positionstringThe bet:
venue:market_id:outcome. A bot's bet count counts these, not rows, so count distinct values for positions.rivo_received_at_utc / seconds_trader_to_rivostring / numberWhen Rivo received the trader's trade, and the seconds from their trade to then.
seconds_after_traderminus this is the bot's own time to decide. Blank on copies made before November 11, 2026 and on some since.
Errors
| Code | When |
|---|---|
NOT_FOUND | No bot of yours has that id. |
VALIDATION | days is outside 1 to 365. |
QUOTA_EXCEEDED | The account has read its trades for the day. |