# reTrade

> We make AI Agentic Trading mistakes insurable. reTrade puts guardrails on AI trading agents: before an agent places an order, reTrade's SDK asks reTrade and gets one of three signed answers, ALLOW, CUT (a smaller size) or BLOCK, with a reason code. Every decision goes into a tamper-evident log, and the SDK keeps the evidence in a claim kit an insurer can check. Pre-release: live trading isn't switched on yet.

reTrade (a working name) is built by Lance Li, Mahimn Patel and Deep Patel, students at the University of Toronto. It is taking design-partner pilots with AI trading companies, insurers and brokers, and has a waitlist for people who let an AI trade their own accounts.

## Facts

- Three answers only: ALLOW, CUT or BLOCK. Nothing waits for a person: there are no holds and no approval step. An order over one of the account's dollar lines, or one that clashes with another agent's order, comes straight back to the agent as BLOCK, with a reason code and the largest quantity that would fit, so the agent can resize, re-plan or ask its own user. A resized order is a new decision, and counts toward the agent's orders-per-minute limit.
- The dollar lines are the business's own: a new account starts at $5,000 an order and $10,000 a day, and the business's admins set their own lines.
- Limits include caps such as "no more than 10% of my money in any one stock", order size, cash, restricted lists and which agents may trade. The business running the agent sets them through an admin API and command line (in development), signed with two or more admin keys. A tighter limit applies at once; a looser one waits 24 hours. An agent's key can't change limits, modes or keys.
- The end user never installs or opens anything from reTrade. The SDK runs with the agent, between it and the broker; reTrade never connects to the broker or holds its login.
- Missing or stale facts mean BLOCK: an unregistered account, a price older than 30 seconds, or a stock it can't match exactly.
- Fail-closed: the SDK gives each decision 2.5 seconds. If reTrade doesn't answer in time, the SDK blocks the order itself.
- Each decision is signed and chained into a tamper-evident log: any later change shows. The SDK keeps the request, the signed answer and the broker's report in a claim kit that reTrade can't alter.
- Every decision is made twice, by the engine and by an independent re-check written separately from the same specification. If they disagree, the answer is BLOCK.
- Pilots are free, run 60 to 90 days on practice trading, and start with success criteria written down.
- reTrade does not hold money or securities, does not move money, and does not provide investment, tax or legal advice. It is not an insurer, does not insure or guarantee against any loss and pays no losses. Insurable means each decision is signed, logged and kept as evidence, so an insurer can underwrite the risk and assess a claim.

## Pages

- [Home](https://retrade.app/): what reTrade is, a limit to try, the pilot request and the waitlist
- [Privacy](https://retrade.app/privacy): what the waitlist and pilot forms keep, and how to have it deleted
- [Legal](https://retrade.app/legal): what reTrade is and isn't, in plain words

## Docs

The developer docs, each page in Markdown (in development: names and formats may change). The web page is the same address without .md.

- [Developer docs](https://retrade.app/docs.md): Developer docs for reTrade, an independent pre-trade check for AI trading agents: install the SDK, check every order and keep signed receipts.
- [Quickstart](https://retrade.app/docs/quickstart.md): Install the reTrade SDK for Python or TypeScript, set your keys as environment variables and run your first pre-trade check on an order.
- [Rules and limits](https://retrade.app/docs/concepts/rules.md): The rules reTrade checks an AI agent’s orders against: caps, cash, restricted lists, which agents may trade and dollar lines, set by admins and never by an AI.
- [ALLOW, CUT and BLOCK](https://retrade.app/docs/concepts/decisions.md): What reTrade’s three answers mean for an AI trading agent: ALLOW places the order, CUT places a smaller size, BLOCK places nothing and says what would fit.
- [Receipts and verification](https://retrade.app/docs/concepts/receipts.md): How reTrade signs and chains every decision into a tamper-evident log, how the SDK checks each answer before acting, and how to read the claim kit.
- [Keys and roles](https://retrade.app/docs/concepts/keys.md): The four kinds of key in reTrade: your bot’s executor key, your admins’ keys, reTrade’s daily decision keys and its root key, and what each one may do.
- [Fail-closed behaviour](https://retrade.app/docs/concepts/fail-closed.md): What the reTrade SDK does when reTrade is slow, down or sends an answer that fails a check: a local BLOCK after 2.5 seconds, with one narrow exception.
- [SDK docs](https://retrade.app/docs/sdk.md): reTrade’s Python and TypeScript SDKs for AI trading agents: the published packages, what they need, what both share and what isn’t built yet.
- [Python SDK](https://retrade.app/docs/sdk/python.md): reTrade’s Python SDK, step by step: install it, make a key, connect your broker, ask for a decision, act on ALLOW, CUT or BLOCK, and keep the claim kit.
- [TypeScript SDK](https://retrade.app/docs/sdk/typescript.md): reTrade’s TypeScript SDK for Node: connect, ask for a decision, act on ALLOW, CUT or BLOCK, the 2.5-second rule, the broker adapter and the claim kit.
- [API reference](https://retrade.app/docs/reference.md): Reference for reTrade’s SDK: client methods in Python and TypeScript, order, account and result fields, HTTP endpoints, request signing and payloads.
- [Reason codes](https://retrade.app/docs/reference/reason-codes.md): Every reason code reTrade gives on a CUT or BLOCK, and the SDK’s own reasons, with what an AI trading agent can do about each one.
- [Errors and troubleshooting](https://retrade.app/docs/errors.md): The reTrade SDK’s errors in Python and TypeScript, and fixes for the common problems: key files, root keys, clocks, stale quotes and an unreachable server.
- [Developer FAQ](https://retrade.app/docs/faq.md): Answers for developers adding reTrade to an AI trading agent: brokers, outages, who sets the rules, shadow mode, insurance evidence and what’s live today.
- [SKILL.md for AI coding agents](https://retrade.app/docs/skill.md): SKILL.md: step-by-step instructions an AI coding agent follows to add reTrade pre-trade checks to an existing Python or TypeScript trading bot.

## For AI coding agents

- [SKILL.md](https://retrade.app/SKILL.md): step-by-step instructions an AI coding agent follows to add reTrade pre-trade checks to an existing Python or TypeScript trading bot
- [All the docs in one file](https://retrade.app/llms-full.txt): every docs page above, in Markdown

## Contact

- Pilots and questions: mahimn@retrade.app