DocsGetting StartedCredits & Plans

Credits & Plans

AI endpoints are metered in credits. The Quant plan includes a monthly grant that resets on the 1st of each month.

How credits work

Data endpoints (exposure, flow, wheels, journal, screener) are covered by your plan's rate limits and cost nothing extra. Only /ai/* endpoints consume credits, because each call runs a model over your data.

Monthly grant

Plan	API access	Credits / month
Quant	Included	500

The grant resets on the 1st of each month (UTC).

Top-up packs: coming soon

Buying extra credits is not available yet. If you run out, the grant resets at the start of the next month - the 402 error tells you exactly when.

What things cost

AI call	Credits
`POST /ai/explain`	1

More AI endpoints (wheel review deep-dives, earnings positioning reads) are coming; each will list its credit cost here.

Check your balance

GET/credits/balance

curl https://quantwheel.com/api/v1/credits/balance

{
  "monthly_grant": 500,
  "remaining": 342,
  "resets_at": "2026-08-01T00:00:00.000Z",
  "topups": "coming_soon"
}

Every AI response also includes credits_used and credits_remaining, so you rarely need to poll this endpoint.

Rate Limits

Active Wheels