Skip to main content
Commit an option only after the person approved that exact option. A commit records a decision. Abacus Labs places no orders. Commits are free.
OPTION_ID is the id of the option the person approved, from results[].data.id of the proposal (the Quickstart sets it in its last step).

Retries and idempotency

So on a timeout or a 5xx, retry with the same key. An option commits once.

What a commit does

  1. Re-checks the option at current prices: cash, whole shares, wash sales, limits.
  2. Signs the result: an Ed25519 certificate over the trades, prices, holdings and checks.
  3. Remembers it. Loss sales in a commit count in every later wash-sale check on that account, and on accounts linked to it.
  4. With fills, updates a saved account to a new version.
A commit is permanent: there is no cancel on the public API. If the person changes their mind before trading, ask for a new proposal and commit the option they choose. The earlier commit stays as a record; until it expires from the 30-day window, its loss sales still count in wash-sale checks, which errs on the safe side.

The answer

201 Created, with Location: /v1/commits/{id}:
On a commit, tax.realized_gain is the gross gain and tax.net the net. tax_rates_source is default when no rates were sent (top federal rates), and request when the request or the saved account gave them. Commit trades use qty; proposal trades use quantity.

Fills

Send what the broker executed. Each fill needs id, symbol, side, qty and price; sells may name lots. This example uses the saved account acct_7f3a from Saved accounts (300 NVDA, and $5,000 of cash after the PATCH there). First a proposal:
The person approves it, and the broker sells 31 NVDA at $162.85. Commit with the fill:
The answer then has status: "filled" (or partially_filled when some trades have no fill yet) and:
The saved account now has 69 shares in lot NVDA-2026-09-01, $10,048.35 of cash, and the sale in history (see Saved accounts). Fills are recorded only with the commit; there is no separate fills call. For later executions, PATCH the saved account (see Saved accounts). GET /v1/commits/{id} returns the commit, with status committed, partially_filled or filled, and its fills.

Stale options

The first three carry replacement_option_id when Abacus Labs can build one. Show the replacement to the person before you commit it.

Verify a certificate

No key needed. Send the commit’s certified object exactly as returned, and signature.value. With the commit answer saved as commit.json:
A changed payload answers {"valid": false, "reason": "signature does not match the payload"}. To verify offline, use the Ed25519 public key at GET /.well-known/jwks.json. A certificate shows what Abacus Labs checked, at which prices. It is not a statement of suitability. Reference: Create a commit, Get a commit, Verify a certificate.