Limits & Quotas

To ensure fair usage and service stability, the Index Alpha API enforces the following limits:

Rate Limit

Rate limits depend on your current plan:

• Free Plan: 10 requests per minute.
• Starter Plan: 120 requests per minute.
• Professional Plan: 300 requests per minute.
• Enterprise Plan: Custom rate limits based on your agreement.

If you exceed these limits, the API returns a 429 Too Many Requests error. The response headers (X-RateLimit-*) provide real-time status of your remaining window.

Monthly Quota

Each API key is assigned a monthly limit across all keys in your account:

• Free Plan: 5 requests per day.
• Starter Plan: 25,000 requests per month.
• Professional Plan: 75,000 requests per month.
• Enterprise Plan: Custom usage limits based on your agreement.
• Check Usage: Use the /usage endpoint to track your current status.
• Reset: Quotas reset at the end of your active subscription period.

Plan Upgrades

When you upgrade from Starter to Professional, your Starter quota is replaced by a fresh Professional quota. Your previous Starter usage does not carry over into the new Professional usage period.

Your API keys stay active and are updated to the Professional plan limits automatically.

Upgrade Example

Starting package:

Plan: Starter
Price paid: Rp200,000
Rate limit: 120 requests per minute
Quota: 25,000 requests
Period: May 1, 00:00 to May 31, 00:00
Usage before upgrade: 20,000 / 25,000 requests
Remaining quota before upgrade: 5,000 requests
Remaining time before upgrade: 15 days

Upgrade event:

Upgrade time: May 16, 00:00
New plan: Professional
Professional price paid on upgrade: Rp350,000

After upgrade:

Plan: Professional
Rate limit: 300 requests per minute
Quota: 75,000 requests
Usage after upgrade: 0 / 75,000 requests
Remaining quota after upgrade: 75,000 requests
Period start: May 16, 00:00
Period end: June 23, 13:42

Explanation:

You pay the full Professional price and receive a fresh Professional quota. The unused 5,000 Starter requests do not stack on top of Professional, and the 20,000 used Starter requests do not reduce your Professional quota.

The unused Starter time is handled separately. It is converted into extra Professional time, then added to the new 30-day Professional period.

Unused Starter value: 15 / 30 * Rp200,000 = Rp100,000
Extra Professional time: Rp100,000 / Rp350,000 * 30 = 8.5714 days
Total Professional period: 30 days + 8.5714 days = 38.5714 days

Downgrades are not allowed during an active subscription period.

Custom Plans

Custom plans are private offers assigned to your account. If you receive a custom offer, it appears on the pricing page after you sign in.

If your custom offer is recurring, the next payment offer is created automatically after you pay. It appears on the pricing page immediately, so you can purchase it early to extend your validity period without waiting for the active custom period to end.

For example, a recurring 30-day custom offer works like this:

May 2: You pay Custom 100K for 30 days.
May 2 to June 1: Your Custom 100K subscription is active.
May 2: The next Custom 100K payment offer appears automatically.
May 10: You pay the next offer early.
June 1 to July 1: The early payment extends your Custom 100K validity for the next 30-day period.