Guides
Credits
How credits are consumed and how to manage your balance.
How credits work
Credits are the unit of billing on Weather Ruse. They reflect the actual data volume of each request.
credits = variables × locationsExamples
| Request | Credits |
|---|---|
| 1 variable, 1 location | 1 credit |
| 5 variables, 1 location | 5 credits |
| 1 variable, 100 locations (batch) | 100 credits |
| 5 variables, 100 locations | 500 credits |
Why credits instead of API calls?
A request for temperature at 1 location costs the same as a request for 20 variables at 100 locations if you used a flat per-call model — but the data volume is 2,000× larger. Credits price the actual work done, keeping things fair for both lightweight and heavy users.
Plan credits
Monthly credits reset on the 1st of each calendar month.
| Plan | Monthly credits |
|---|---|
| Free | 100,000 |
| Starter | 1,000,000 |
| Pro | 10,000,000 |
| Enterprise | 100,000,000+ |
Credit packs
One-time credit top-ups that never expire:
| Pack | Credits | Price |
|---|---|---|
| Starter pack | 500,000 | $9 |
| Growth pack | 2,000,000 | $29 |
| Scale pack | 10,000,000 | $99 |
Buy packs from the Billing page.
Checking your balance
# From the API
curl -H "Authorization: Bearer $WR_KEY" \
https://api.weather-ruse.com/v1/account/balanceOr view in real-time on the console.
Insufficient credits
When your balance reaches 0, the API returns:
{
"error": "insufficient_credits",
"message": "Your account has no available credits.",
"status": 402
}Monthly credits and credit packs are combined into a single pool. Pack credits are consumed first.