Plans
All plans reach the same routes. They differ in call quota, rate limit and how far back the history goes.
Free
For trying it out and small personal projects.
- 10,000 calls per month
- 10 calls per minute
- History up to 24 hours back
- All current routes
Developer
For bots, trackers and tools with real users.
- 250,000 calls per month
- 60 calls per minute
- History up to 7 days back
- All current routes
Pro
For dashboards and services that poll often.
- 2,000,000 calls per month
- 300 calls per minute
- History up to 30 days back
- Player routes when they launch
Side by side
Same numbers, one table. Still provisional.
| Limit | Free | Developer | Pro |
|---|---|---|---|
| Calls per month | 10,000 | 250,000 | 2,000,000 |
| Calls per minute | 10 | 60 | 300 |
| History window | 24 hours | 7 days | 30 days |
| Data refresh | Every 5 minutes | Every 5 minutes | Every 5 minutes |
| Price per month | $0 | $5 | $15 |
Questions
What counts as a call?
One HTTP request to any route is one call, whatever the size of the response. /v1/status is never counted.
What happens when I hit my limit?
The API answers with status 429 until the limit resets. A minute limit comes with a retry-after header that tells you how long to wait. Every response carries headers with what you have left.
Is this the official DonutSMP API?
No. DonutSMP disabled its official API in 2026. API keys were first restricted to ranked players on July 3, 2026, then DonutSMP staff announced on September 29, 2026 that it was fully disabled, for abuse and safety reasons. In the game, the /api command now answers that the API has been disabled. Donut API is an independent, unofficial replacement that provides the same kind of data through bots in the game.
When can I sign up?
You do not need to: the API answers without a key, within the keyless limits above. Sign up, API keys and paid plans are not open yet. This page will carry the link when they are.