CORAL

Safety & risk

The model may be
optimistic.
The gate may not

CORAL is an agent that can place orders. That sentence should make you uncomfortable, and the design below is a response to that discomfort rather than a reassurance about it.

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.

limitdefaultenforced as
maxOrderUsd250Ceiling on one order. Larger requests are scaled down, not rejected.
maxDeployedUsd2,500Total open cost basis. When the book is full, nothing new opens.
maxPositionPct0.25Per-symbol ceiling measured against maxDeployedUsd, so the cap is fixed rather than moving with the book.
minConfidence0.55Below this, a buy is refused however good the thesis reads.
maxConsecutiveLosses4Circuit breaker on settled losses. Then no new risk.
maxDailyLossUsd150Daily realised-loss cap. Hit it and the reef stops for the day.
symbolBlocklist[]Symbols CORAL may never touch, whatever the setup looks like.
allowLivefalseThe 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.
what a refusal looks like
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
what going live takes
# 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.

CORAL

Six switches
stand between
a prompt and your money

How the pass produces these numbers