Skip to main content
A policy is the person’s rules in one object. POST /v1/proposals takes a goal in plain English, a policy, or both. Abacus Labs reads the goal into a policy, lays the fields you send over it, solves it, and echoes the result in understood.policy. Order (later wins): the saved account’s policy, then what Abacus Labs read from goal, then the policy you send. To change one thing, edit that field in understood.policy and send it back. The same policy on the same account gives the same answer. Every field is optional. Weights are fractions of the account (0.10 = 10%). Money is in dollars.

Fields

Unknown fields are refused with 422 invalid_policy; param names the field.

Goals

The layered solver gives exact rules and a proven bound. Templates are rule-based. provenance.engine says which ran, and warnings says why when the layered solver was not used.

Benchmark

Default: current for most goals. For invest_cash, track_benchmark and rebalance, and for an account that is mostly cash, the account’s index: SPY unless you set one. understood.resolved.benchmark shows what was used.

Themes

exclude_themes accepts: alcohol, banks, defense, firearms, fossil fuels, gambling, oil and gas, pharma, reits, semiconductors, tobacco. Common words map to them (coal and energy to fossil fuels, guns to firearms, casinos to gambling, chips to semiconductors). Industry themes use the risk model’s industry groups; the others use a short ticker list. A theme word Abacus Labs does not know is named in warnings.

What a saved account keeps

With save: true, the account keeps the standing parts of the policy: benchmark (unless current), tracking error, tax rates, max_tax and max_gain, keep and exclude lists, position and sector limits (except the one a concentration or sector goal was cutting), trading rules and monitor. It drops the one-off parts: goal, trades, theme, cash and tax.mode.

Examples

understood.read_from_text lists the fields Abacus Labs took from the goal, and understood.confidence how sure it was. Below the threshold, outcome is clarify and understood.question says what to ask the person.