James Docs

How Credits Work

Credits are consumed each time you use an AI-powered feature. Here's everything you need to know.

Every action on the platform that involves computation or AI processing costs credits. Credits are deducted at the moment a request is submitted. If the request fails for any reason — network error, AI timeout, or data unavailability — the credits are automatically refunded to your account.

Feature Costs

FeatureBase CostNotes
TA Analysis1 creditBase cost before add-ons
Wallet Tracker1 creditMulti-chain wallet analysis
ONYX AI3 creditsPer query, includes tool calls
Real YieldFreeDeFi yields, node ROI — no credits needed
DashboardFreeMarket data across all asset classes
NewsFreeAggregated news + AI summary

TA Add-ons

Technical analysis requests can be extended with add-on indicators and a market prediction engine. Each add-on is priced separately and stacks on top of the 1-credit base cost.

Add-onExtra CostDescription
MACD Histogram+1 creditMoving Average Convergence Divergence with histogram
Thermal Map+1 creditHeatmap overlay for price density and volume clusters
Cycle Pulse+2 creditsMarket cycle detection and phase analysis
Smart Flow+2 creditsSmart money flow indicators and institutional signals
Prediction — Standard+5 creditsAI-generated directional price prediction
Prediction — Advanced+15 creditsHigh-confidence prediction with extended horizon

Maximum TA Cost

Selecting every base indicator, all four add-ons, and the Advanced Prediction results in a maximum of 22 credits for a single TA request. Most users run a base analysis with one or two add-ons, keeping costs between 1 and 6 credits per request.

Free Plan Daily Credits

Users on the Free plan receive 2 daily credits that reset automatically at midnight UTC. These free credits are separate from any subscription or top-up credits and do not accumulate — unused free credits expire at the reset and are not carried forward.

Admin accounts are excluded from the daily credit reset and do not receive free credits.

Spending Priority

When you have credits from multiple sources, the platform always spends them in the following order:

PriorityCredit TypeWhen Used
1stFree (daily)Used first on every request
2ndSubscriptionUsed after free credits are exhausted
3rdTop-upUsed after subscription credits are exhausted
4thAdmin GrantUsed last, after all other credits

This ordering ensures your free daily allocation is always consumed first, preserving your paid credits for when you need them most.

Top-up Credits Are Permanent

Credits purchased through a top-up pack are permanent — they never expire and survive plan changes or cancellations. If you downgrade from a paid plan to Free, your subscription credits are removed but any top-up credits you purchased remain on your account indefinitely.

If an analysis or ONYX AI query fails for any reason, credits are automatically refunded to your account. You will see an error message and your credit balance will be restored within seconds.