Monthly dollar budgets #
On this page
Give an Anthropic API account a monthly allowance in dollars, with the day it resets, and decide what Maple does when it is spent: warn you, move requests to a fallback, or refuse them. People and teams on a shared proxy can have dollar caps too.
Every dollar figure Maple counts itself is an estimate. Maple prices the usage Anthropic reports for each request at Anthropic's published list prices, for the requests that go through this proxy only. It never sees your balance. The Claude Console is the authority on what you spent and what is left, and Maple can show Anthropic's own figures beside its estimate: see Check against Anthropic's bill.
If you set no dollar budget, nothing changes: no new messages, no new limits.
In plain words #
Anthropic doesn't tell an app how much money an API key has left. So if you give Maple a key with a fixed amount behind it (the monthly API credits of a Claude Max or Team plan, or a limit you set yourself), Maple can't know when it runs out until Anthropic starts refusing requests.
A dollar budget fixes that from Maple's side. You tell Maple "about $100 a month, starting on the 14th". Maple adds up what each request would cost at Anthropic's list prices, warns you at 80% and at 100%, and at 100% sends further requests to another model you chose (or stops, or only warns, as you prefer). On the 14th it starts again from zero.
To set one:
- Add the Anthropic key to Maple (see Sign in), if it is not there already.
- On the setup page, open Costs & budgets and find the Monthly dollar budgets card. Press Set a dollar
budget under the account, enter the dollars a month and the day the month starts, and press Save dollar
budget (below). Or add a
budgets:entry inconfig.yaml(The settings). - Optionally, set a fallback model for when the budget is spent (Fallbacks).
If you have a Claude Max or Team plan, follow Use your Max or Team credits with Maple below: it adds a spend limit on Anthropic's side as well, which is exact.
On the setup page #
Costs & budgets, the Monthly dollar budgets card. The card is shown when the proxy has an account it can price in dollars: Anthropic, Amazon Bedrock, Google Cloud, Microsoft Azure (Claude), and xAI. Any other account is listed once, at the bottom, as "Not priced in dollars here": its requests count $0 against a dollar budget.
For each account, Set a dollar budget (or Edit, once there is one) opens:
| Field | What to enter | Key |
|---|---|---|
| Dollars a month | The month's allowance, in estimated dollars at list prices | max_usd_per_month |
| Month starts on day | 1 to 31: the day it resets, at 00:00 UTC. For Max or Team credits, your plan's billing day | month_starts_on_day |
| When it is spent | only warn: requests go on, move requests to their fallbacks (the default), or refuse requests until it resets | when_spent (warn, fallback, stop) |
| Where the money comes from | Not said, A Max or Team plan's monthly API credits, Credits you bought, or A spend limit you set in the console. A label only | source |
Save dollar budget writes it to config.yaml, and it counts from the next request; Remove dollar budget
takes it away (the account's daily request and AI-unit limits, if any, stay).
With a budget set, the account's line shows:
- "About $X of $Y used since <date> (estimated, at list prices, through this proxy only)", and a bar;
- "Resets on <date> at 00:00 UTC", what happens when it is spent, and where the money comes from;
- after three days of usage, the forecast: "runs out around ..." or "lasts until it resets ..., with about $X left unused", estimated;
- Price notes, when a model could not be priced exactly since the proxy started: whether it was estimated at its family's price or not counted.

Changing a budget is for the setup page on the proxy's own machine. Through single sign-on the card is read-only; people's and teams' caps follow the usual People rules. When the proxy's settings come from files managed elsewhere (a Kubernetes ConfigMap), the card is read-only too: change the file.
The settings #
budgets:
- provider: anthropic # the provider's id
max_usd_per_month: 100 # estimated dollars a month, through this proxy
month_starts_on_day: 14 # optional: 1 (the default) is the calendar month
when_spent: fallback # optional: warn | fallback (the default) | stop
source: subscriber_credits # optional: subscriber_credits | purchased | spend_limit
| Key | Default | What it does |
|---|---|---|
max_ | none | The month's allowance, in estimated dollars. It counts on its own: estimate_cost does not have to be on (that setting only decides whether /cost shows a dollar figure) |
month_ | 1 | The day of the month the budget resets, at 00:00 UTC. 1 to 31; a day past the month's end means its last day, so a budget that starts on the 31st resets on 28 or 29 February, 30 April and so on |
when_spent | fallback | What happens at 100%: warn only alerts and requests go on; fallback refuses this account with budget_exceeded so the request moves on to its fallbacks, and with none left the caller gets a 429; stop answers the 429 at once, without trying fallbacks |
source | none | A label for where the money comes from. It changes no behaviour |
A dollar budget can sit in the same entry as max_requests_per_day and max_ai_units_per_day; each limit counts on
its own. month_starts_on_day, when_spent and source need max_usd_per_month. The setup page writes the same
keys; a file you edit yourself is applied once saved.
What counts #
- Every request Maple sends to the account, priced from the token counts in Anthropic's answer: input, output (thinking included, as Anthropic bills it), cache reads, and cache writes at their 5-minute or 1-hour price. The long-prompt price of Claude Haiku 5.5, US-only inference, fast mode, the batch tier and web searches are priced too when the answer says they were used.
- A request that failed or was cut off part way counts for what Anthropic reported before it stopped.
- The proxy's own cache-warming requests count against the account's budget (they are billed), but not against any person's or team's.
- An answer from the response cache never counts: nothing was sent.
- A Claude model that is not yet in Maple's price list is counted at the highest list price of its family (Opus, Sonnet, Haiku and so on), and the proxy's log says so once per model. A model with