Skip to main content
Every call takes the person’s account in one of these ways: An inline account is kept for 24 hours (account_expires_at), so its id and snapshot_id work in follow-up calls; then it is forgotten. A saved account stays until you delete it. Either way the account counts as one portfolio for the month: send the same id each time. Send what the broker gives you and leave out what it does not. Abacus Labs never treats a missing cost as 0.
Numbers are JSON numbers (strings holding numbers are accepted). Money is in dollars, quantities in shares, rates and weights are fractions. Dates are YYYY-MM-DD. Account ids and lot ids come back exactly as you sent them. Trades and lot instructions use each symbol as you sent it (BRK.B stays BRK.B). Analysis results and saved accounts use an upper-cased form with . and / turned into - (BRK-B). A lot sent without an id gets one (lot_3). An account saved without an id gets an Abacus Labs id (acct_...).

Account

Position

Lot

Only an average or total cost for the position? Send one lot: { "quantity": 15, "cost_basis": 2400 }. No cost? Leave out lots. Lots cover part of the position? The rest has unknown cost.

What Abacus Labs does with missing data

Proposals and trade checks list the gaps in provenance.data_quality (unknown_cost, unknown_term, unresolved_symbols) and say what each one means in warnings. Symbols Abacus Labs could not price are left out of value, weights and risk.

Several accounts

Send all of the person’s accounts. Analysis treats them as one household (tax stays per account). A proposal or trade check trades in one account, named by account_id (required when you send more than one). All accounts count for wash sales: a loss sale in one account is blocked if the same security, or a fund that tracks the same index, was bought in any account within 30 days, including IRAs. wash_sale_policy: "exact" counts only the same security. Saved accounts also remember the loss sales you committed.

Aggregator payloads

Set source.format to send an aggregator’s data as it comes: An empty tax_lots list from either means “not supplied”, not “no lots”. Send each account once, by one route: the same id twice is 422 duplicate_account.