Guides

Usage limits

The Kokos API is included with your Kokos Activator subscription. When you go over your quota, you can buy additional requests.

Subscription

Your active subscription includes 300 free activations per day.

You’ll lose API access if your subscription expires! Consider renewing for multiple months at once to avoid interruptions.

This 300 request limit is counted over a rolling 24-hour period. Here’s an example usage graph:

Example usage graph

Extra requests

You can buy additional activations through the bot at $10 per 1000 requests. These don’t expire, but you still need an active subscription to use the API.

Your daily subscription quota is used first.

Unused daily requests don’t roll over to the next day.

What counts toward your quota

Three endpoints use your activation quota:

  • POST /redeem - 1 activation per request
  • POST /redemption-time - 1 activation per request
  • GET /character - 0.25 activations per request

All other endpoints are free and don’t count toward your quota.

Exceeding your quota

When you go over your limit, you’ll get a 429 status code with a response like this:

Response
1{
2  "error": "Too many requests",
3  "limit": 300
4}

The limit field shows your daily subscription quota (always 300).