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
- Re-checks the option at current prices: cash, whole shares, wash sales, limits.
- Signs the result: an Ed25519 certificate over the trades, prices, holdings and checks.
- Remembers it. Loss sales in a commit count in every later wash-sale check on that account, and on accounts linked to it.
- With
fills, updates a saved account to a new version.
The answer
201 Created, with Location: /v1/commits/{id}:
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 needsid, 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:
status: "filled" (or partially_filled when some trades have no fill yet) and:
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’scertified object exactly as returned, and signature.value. With the commit answer saved as commit.json:
{"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.