Rate limiting
Understand the rate limits for Hiro APIs and testnet faucets.
API rate limits
You can access all of Hiro's API services without an API key, but you are subject to rate limits of 25 RPM, per client IP. To build with higher rate limits, you can generate a free API key in the Hiro Platform that is set to the free "starter" plan as a default, and you can upgrade your account to a higher tier as needed:
| Tiers | API RPM | Stacks L2 requests / month | Bitcoin L1 requests / month |
|---|---|---|---|
| No API key | 25 | n/a | n/a |
| Free / Starter | 900 | 150K | 50K |
| $99 / Build | 3K | 15M | 500K |
| $599 / Scale | 7K | 75M | 5M |
| Enterprise | Custom | Custom | Custom |
With a single API key, you gain access to Hiro's suite of API services that span Bitcoin and Stacks:
Bitcoin L1 API services
- Ordinals API (includes BRC-20 support)
- Runes API
Stacks L2 API services
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.
You can create one for free in the Hiro Platform by creating an account.
STX / sBTC testnet faucet rate limits
Note: these faucets are for Stacks and sBTC testnet tokens, which have no monetary value.
| Type | Rate Limit |
|---|---|
| Stacking requests | 1 request per 2 days |
| Regular STX / sBTC requests | 1 request per minute (RPM) |
To use the faucets, visit the Hiro Platform Faucet.