# Download Bot Trades

> Downloads a bot's trade-by-trade record as CSV: a trader or signal bot beside its trader's trades, a market bot's entries and exits.

Source: https://rivo.markets/docs/reference/download-bot-trades

`GET /v2/bots/{id}/audit.csv`

Scope: `read`

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:

```bash
curl "https://api.rivo.markets/v2/bots/trader%3A7f3a2b10-4c1d-4e8a-9b2f-3d6e5a1c0b77/audit.csv?days=30" \
  -H "Authorization: Bearer rivo_live_..."
```

Python:

```python
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())
```

TypeScript:

```typescript
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

- `id` (string, required): The bot's id, as [List Bots](https://rivo.markets/docs/reference/list-bots) returns it: `trader:<id>`, `signal:<id>` or `market:<id>`.

## Query parameters

- `days` (integer, optional, default `90`): How far back to reach, from 1 to 365 days.

## Example response

```json
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

- `row` (string): `bot decision` for a trade the bot decided on, `trader sale` for a sale by the trader in a market the bot bought.
- `bot_decided_at_utc / trader_traded_at_utc / seconds_after_trader` (string / string / number): When the bot decided, when the trader traded, and the gap in seconds.
- `trader_fill_* / trader_order_*` (number): The trader's fill the bot saw, and their whole order at that moment: its dollars, average, lowest and highest price.
- `mode` (string): `paper` or `live`.
- `bot_action / bot_status / skip_reason / detail` (string): What the bot did: `BUY` or `SELL` and the order's status, or the skip and why.
- `bot_limit_price / bot_fill_price / bot_shares / bot_fee_usd` (number): The bot's order: its price limit, average fill, shares filled and the venue's fee.
- `order_sent_at_utc / order_seconds_working` (string / number): When 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_asks` (string / number / number / number / string): The order book the live order was sized from: when it was read, the cheapest ask (`none offered` when nobody was selling), the contracts offered at or under the bot's limit and what they cost, and up to 10 ask levels, as `69c 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_limit` (number): For 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_usd` (number): What a buy cost with its fee, or what a sale brought in after its fee.
- `market_result_for_outcome` (string): `won`, `lost`, or `open` for the row's outcome.
- `source_trade_id` (string): The 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.
- `position` (string): The 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_rivo` (string / number): When Rivo received the trader's trade, and the seconds from their trade to then. `seconds_after_trader` minus 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. |
