> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abacuslabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits and plans

> What each call costs, how effort and max_credits work, what counts as a portfolio, and the 402 errors.

Calls that do work cost credits. The price is fixed by the call and its `effort`, so you know it before you call. Commits, account reads and account changes are free. Holdings and benchmark reads cost 1 credit. Failed calls and goals Abacus Labs cannot meet are free.

## Prices

| Call | `quick` | `standard` (default) | `deep` |
| - | - | - | - |
| `POST /v1/analyze` | 5 | 15 | 40 |
| `POST /v1/proposals` | 10 | 25 | 60 |
| `POST /v1/proposals`, building a direct index from cash | 100 | 100 | 200 |
| `POST /v1/trades/check` | 5 | 5 | 5 |
| `GET /v1/accounts/{id}/holdings`, `GET /v1/benchmarks`, `POST /v1/benchmarks/resolve` | 1 | 1 | 1 |
| Commits, certificates, other `GET` calls, `/v1/accounts`, `POST /v1/keys` | 0 | 0 | 0 |

The first direct-index build of each portfolio is free. MCP tools cost the same as the REST call they wrap.

**Free, whatever the call:**

* Errors (`4xx`, `5xx`) and timeouts.
* A proposal whose `outcome` is `infeasible`, `clarify` or `no_change` (it gave no options).
* A trade check whose `status` is `rejected`. A `pass` or `repaired` check costs 5 credits.

## Effort

`effort` is `quick`, `standard` or `deep`. It sets how much work a call does, and its price.

| Call | `quick` | `standard` | `deep` |
| - | - | - | - |
| Analyze | At most 2 analyses | At most 6 | At most 10 |
| Proposals | About 2 s of solver search per option | About 6 s | About 20 s; can tighten the guarantee |

## `max_credits`

Send `max_credits` on analyze, proposals or trade checks to refuse the call if it would cost more. Nothing is charged:

```json theme={null}
{ "error": { "code": "max_credits_exceeded", "message": "this call costs 25 credits, above max_credits 10; nothing was charged",
             "price": 25, "max_credits": 10, "param": "max_credits", "effort": "standard", "http_status": 402 } }
```

## Headers

Every authenticated `/v1` response carries:

| Header | Meaning |
| - | - |
| `Abacus-Credits-Charged` | Credits this call cost. |
| `Abacus-Credits-Remaining` | Credits left this month, after holds. |
| `Abacus-Credits-Held` | Only on a `202` proposal: credits held until it finishes. |

The body of analyze, proposals and trade checks also carries `credits_charged` (and `credits_held` on a `202`). Over MCP there are no headers, so read `credits_charged` in the result.

**Async proposals.** A proposal that answers `202` holds its price. When it finishes, the hold becomes the charge (or is released if it failed or the goal could not be met). The poll that returns the finished proposal reports the settled `credits_charged`. The polls themselves are free.

## Portfolios

A portfolio is an account that Abacus Labs works on in a calendar month: saved, analysed, proposed for or checked. The same account counts once a month, however often you call.

* An inline account counts when you first send it. Its `id` identifies it, so send the same `id` every time.
* `POST /v1/accounts` counts the account it saves.
* Demo accounts (`acct_demo_*`) never count.

At the limit, accounts you already used this month keep working. A call on a new account answers `402 portfolio_limit_reached`.

## Plans

| Plan | Price | Portfolios | Credits a month | At the limit |
| - | - | - | - | - |
| Personal | Free | 3 | 300 | Hard stop. For your own accounts only. |
| Startup | \$299 a month | 100 | 10,000 | Top-ups: \$10 for 1,000 credits |
| Professional | \$1,499 a month | 1,000 | 100,000 | Top-ups |
| Custom | Annual licence | 2,000+ | Pooled | By contract |

Every plan gives 100 credits a month per portfolio. Unused plan credits roll over one month, up to twice the monthly allowance. Top-up credits never expire. Choose a plan, buy top-ups, and set a monthly spend cap in the [dashboard](https://app.abacuslabs.ai). Full details: [abacuslabs.ai/pricing](https://abacuslabs.ai/pricing.html).

The API has no balance call. Read `Abacus-Credits-Remaining` on any call, or the dashboard.

## The 402 errors

| `code` | Why | What to do |
| - | - | - |
| `max_credits_exceeded` | The call costs more than your `max_credits`. `price` says how much. | Raise `max_credits`, or lower `effort`. |
| `credits_exhausted` | Not enough credits this month, or a key's or the organisation's spend cap is reached. `balance` and `price` say how much. | Tell your human. On Personal, wait for next month or upgrade (`upgrade_url`). On paid plans, top up (`top_up_url`). |
| `portfolio_limit_reached` | A new account would pass the plan's portfolio limit. `used`, `limit` and `accounts` say which. | Use an account already counted this month, or upgrade (`upgrade_url`). |

```json theme={null}
{ "error": { "code": "portfolio_limit_reached",
             "message": "this organisation works on 3 of 3 portfolios this month; a new portfolio needs a pack of portfolios or a bigger plan. Portfolios already counted this month keep working.",
             "used": 3, "limit": 3, "accounts": ["limit_3"], "upgrade_url": "https://app.abacuslabs.ai/billing", "http_status": 402 } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.