Billing
How each NeuroAPI call debits your quota, what blocks a call, and how to track what's left.
Billing is plan-based: each successful /agent/ask call debits cost_units from
your current period's quota, and the value depends on the mode you ask
in.
The unit of billing
Every successful /agent/ask response carries a usage block:
{
"usage": {
"prompt_tokens": 124,
"completion_tokens": 256,
"cost_units": 2
}
}prompt_tokens and completion_tokens come from the underlying model
provider and are informational. cost_units is what NeuroAPI charges.
Cost by mode
| Mode | cost_units | Required plan | What it's for |
|---|---|---|---|
fast | 1 | All plans | Quick answers with core market knowledge. Good for asset checks, market sentiment, and high-volume financial Q&A. |
smart (default) | 2 | All plans | Deeper reasoning and more market context for complex questions. Good for technical analysis, trade setups, and fundamental stock research. |
max | 8 | Pro, Enterprise | The deepest research: multi-asset investigations and fundamental analysis with broad market coverage. |
Calling max on the Starter plan returns 403 with
code: "mode_not_in_plan". Upgrade to Pro to use it.
Plans
The Pricing page has the full per-plan breakdown: monthly quota, rate limit, key cap, and support tier. Two rules matter for billing:
- An active subscription is required for every endpoint,
/healthincluded. /healthis free: it never consumes quota.
When billing blocks a call
| Situation | Response |
|---|---|
| No active subscription (never subscribed, or canceled) | 403 no_active_subscription |
| A payment failed | 402 payment_required |
| The period's quota is spent | 429 quota_exceeded |
A failed payment pauses API access until it is resolved:
HTTP/1.1 402 Payment Required
Content-Type: application/json{
"detail": {
"code": "payment_required",
"message": "Your last payment failed, so API access is paused. Update your payment method at https://neuroapi.neurobro.ai/billing to restore it."
}
}To resolve it, open the dashboard → Billing & Plans and subscribe, update the payment method, or upgrade. Your API keys stay valid throughout, and a successful payment restores access right away.
Quota emails
NeuroAPI emails you as usage approaches your quota. By default you get one at 80% and one when the quota is used up (100%). To choose which ones you get (50%, 80%, 90%, 100%, or none), open the dashboard → Account → Notifications. Payment, security, and account emails always go out.
Programmatic visibility
The dashboard's Usage page summarizes billable counters per period.
For per-request visibility, read usage.cost_units on each response,
the source of truth for what a single call cost. The last call of a
period can cost less than its mode's price. A max call (8 units) with
7 units left runs and reports cost_units: 7. The next call returns
429 quota_exceeded.
To see how much of the period's quota is left, read the X-Quota-*
headers. Every billable response carries them, so you can react before a
429 arrives.
| Header | Meaning |
|---|---|
X-Quota-Limit | Cost units included in the current period. |
X-Quota-Remaining | Cost units left before the quota is exhausted. |
X-Quota-Reset | Unix timestamp at which the period rolls over. |
HTTP/1.1 200 OK
X-Quota-Limit: 10000
X-Quota-Remaining: 9421
X-Quota-Reset: 1789903258These travel on billable calls only: /health is free and reports no
quota. They are separate from rate limits: quota is
the period budget, the rate limit is a short sliding window, and either
can reject a call on its own.