
Safety & risk
The model may be
optimistic.
The gate may not
Read this first. CORAL is not investment advice and it is not a money machine. Automated trading can lose money faster than manual trading, because it is faster. You are responsible for every order an agent places on your account, including the ones you did not watch.
Hard limits
These live in packages/core/src/safety/risk-manager.ts as a Zod-validated object, and every one of them is enforced in code that runs after the model has spoken. The defaults below are what ships. Changing them is a deliberate edit to a source file, not an environment variable you can fat-finger.
| limit | default | enforced as |
|---|---|---|
| maxOrderUsd | 250 | Ceiling on one order. Larger requests are scaled down, not rejected. |
| maxDeployedUsd | 2,500 | Total open cost basis. When the book is full, nothing new opens. |
| maxPositionPct | 0.25 | Per-symbol ceiling measured against maxDeployedUsd, so the cap is fixed rather than moving with the book. |
| minConfidence | 0.55 | Below this, a buy is refused however good the thesis reads. |
| maxConsecutiveLosses | 4 | Circuit breaker on settled losses. Then no new risk. |
| maxDailyLossUsd | 150 | Daily realised-loss cap. Hit it and the reef stops for the day. |
| symbolBlocklist | [] | Symbols CORAL may never touch, whatever the setup looks like. |
| allowLive | false | The second live switch. Needs this and CORAL_MODE=live. One alone does nothing. |
Three failure modes, taken seriously
The model is wrong, confidently
Assumed, not prevented. The gate does not care how persuasive a thesis is. Sizing, concentration, and the loss streak are checked against numbers, so a high-confidence call still gets refused when the book is full or the day is red.
Data is stale, or synthetic
Every observation carries its source, and the source is copied into the polyp's artifacts. A decision made on a synthetic tape stays labelled as such. It can teach the reef, but it can never be presented as a real trade.
An agent host tries to place an order directly
Through CORAL's own MCP surface, coral_trade is the only write tool, it defaults to a dry run, and it always runs the gate. The Robinhood place-order skill exists for completeness, but the engine is the only caller holding a sanctioned verdict.
Non-negotiables
Six things that will not be traded away for a nicer demo.
- Paper mode is the default in code, not in documentation.
- Live requires CORAL_MODE=live and limits.allowLive=true. Both.
- Fees are charged on every paper fill, because optimistic accounting is a lie with a compounding interest rate.
- A refused decision still becomes a polyp, tagged gated, with the reason frozen in its artifacts.
- A polyp cannot be settled in the same hour it was made.
- No prompt text is ever treated as a safety control.
Rejected by the risk manager
NVDA buy: confidence 0.48 < minConfidence 0.55
TSLA buy: circuit breaker, 4 consecutive
losses (limit 4)
GME buy: GME is blocklisted
# each one still became a polyp, tagged
# "gated", reason in artifacts# 1. environment
CORAL_MODE=live
ROBINHOOD_MCP_TOKEN=...
# 2. a source edit, on purpose
RiskManager.forMode("live")
→ limits.allowLive === true
# 3. a CLI confirmation
$ coral trade NVDA --yes
LIVE MODE · budget $200 · max 1 order
# one switch alone places nothing.What CORAL cannot do, by construction
Sign or submit on-chain transactions. The chain client is read-only.
Move funds, withdraw, or touch any non-Agentic account.
Trade short, on margin, or with leverage. The action set has no such verbs.
Rewrite its own limits, prompts, or risk rules.