NeuroAPI
GuidesBilling

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

Modecost_unitsRequired planWhat it's for
fast1All plansQuick answers with core market knowledge. Good for asset checks, market sentiment, and high-volume financial Q&A.
smart (default)2All plansDeeper reasoning and more market context for complex questions. Good for technical analysis, trade setups, and fundamental stock research.
max8Pro, EnterpriseThe 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, /health included.
  • /health is free: it never consumes quota.

When billing blocks a call

SituationResponse
No active subscription (never subscribed, or canceled)403 no_active_subscription
A payment failed402 payment_required
The period's quota is spent429 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.

HeaderMeaning
X-Quota-LimitCost units included in the current period.
X-Quota-RemainingCost units left before the quota is exhausted.
X-Quota-ResetUnix timestamp at which the period rolls over.
HTTP/1.1 200 OK
X-Quota-Limit: 10000
X-Quota-Remaining: 9421
X-Quota-Reset: 1789903258

These 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.

On this page