Contents
Hiro hosts multiple enterprise-grade API services at scale, including the Stacks Blockchain API, the Ordinals API, and the Token Metadata API. These APIs have default rate-limits in order to provide the broadest possible API access to developers.
To better support the Stacks community and developers, we’re updating the API rate limits for all Hiro-hosted API services. This change will go into effect on November 9th, 2023. The new rate limit policy is:
Updated API access rates: going into effect on November 9th
- 50 RPM per client IP for unauthenticated traffic (without an API key)
- 500 RPM per client IP with an authenticated API key, (generate a key in the Hiro Platform)
We are making this change for two primary reasons. First, we care about strong traffic attribution because that attribution helps us understand who our customers are and how they use our products. That in turn helps us build better products and experiences for you.
Second, this will help us reduce unauthenticated traffic, which has the effect of reducing bots, denial of service attacks, and other non-productive traffic.
Need a Higher Rate Limit?
These new rate limits help us ensure fair usage of Hiro APIs and provide the best possible service as our community of developers and applications grow and scale. However, as your app and users grow, these default API rate limits may not work for your needs, especially if you are seeing exponential growth.
This is a great problem to have, and we’re here to help. Please generate your API keys in the Hiro Platform, and if you need a higher RPM, reach out to us at platform@hiro.so.
What to Do Ahead of These Changes?
We strongly encourage all teams to consider authenticated API access via an API key as a best practice.
If your usage rate exceeds 50 requests per minute, please generate a key at your earliest convenience. If your rate limits fall under 50 RPM, and you prefer unauthenticated access, no further action is required.
If you already have an API key, you will be grandfathered into this new policy.
You can learn more about our policies in Hiro’s Terms of Use. If you have any questions, don’t hesitate to reach out to us on the Hiro Developer Tools channels on Discord.
