Skip to main content
POST
Create a proposal

Authorizations

Authorization
string
header
required

An API key: abacus_sk_test_... (sandbox, from POST /v1/keys) or abacus_sk_live_... (from https://app.abacuslabs.ai)

Headers

Idempotency-Key
string | null

optional: any unique string (a UUID). A retry with the same key and body within 24 hours returns the stored answer with Idempotent-Replayed: true and is not charged again; the same key with a different body is 409 idempotency_key_reused

Query Parameters

wait
number | null

Body

application/json

A goal in plain English. Send the person's accounts; trades go to account_id, and every account counts for wash sales.

accounts
Accounts · object[] | null

every account to consider (Account objects; see the data model). Any mix of brokers and tax types

account_id
string | null

the account to trade in; required when more than one account is sent

account
Account · object | null

v2: one inline account, or {id} of a stored account

snapshot_id
string | null

a book sent earlier, instead of accounts

goal
string | null

what the person wants, in plain English

policy
Policy · object | null

the policy (see the policy schema); any field set here wins over what Abacus Labs reads from goal

save
boolean
default:false

save the account (with the policy Abacus Labs used) and return its account_id

effort
enum<string>
default:standard

how hard the solver searches: quick (about 2 s a variant), standard, deep (about 20 s); priced per effort

Available options:
quick,
standard,
deep
max_credits
integer | null

refuse the call when it would cost more credits than this

Required range: x >= 0
options
integer
default:3

how many options to return

Required range: 1 <= x <= 5
constraints
Constraints · object | null

deprecated: use policy. max_tax, max_estimated_tax, max_turnover, keep, exclude, universe, no_sells, max_names

tax_rates
Tax Rates · object | null

{short_term, long_term}: all-in marginal rates as fractions

wash_sale_policy
enum<string>
default:same_index

same_index: funds tracking the same index count as identical; exact: only the same security

Available options:
same_index,
exact
benchmark

default SPY. A ticker or index name, plain English ('half S&P 500, half ARKK'), or an object: {mix: [{benchmark, weight}]}, {manager: name or CIK} (13F), {weights: {symbol: w}}. Prefer policy.benchmark

detail
enum<string>
default:compact

compact: the recommended option, its impact and one-line alternatives; full: every option in full

Available options:
compact,
full

Response

Successful Response