Quotas and rate limits
Last updated
Last updated
Quotas and rate limits for requests are separated into two categories: blockchain and non-blockchain requests. A request is considered a blockchain request if it involves performing an action that creates a blockchain transaction.
Currently, the API has the following blockchain requests: addItem, addMemory, transferItem
The rest are considered non-blockchain requests. Some examples of non-blockchain requests are: getItem, getMemory, addMetadata, listContracts, etc.
Your subscription plan comes with two blockchain smart contracts. One for Polygon (mainnet) transactions and another for Polygon Mumbai (testnet) transactions. The Polygon testnet contract is meant for testing purposes. The quotas for Poygon mainnet and Polygon testnet differ.
Items: The number of Items you can mint per month (addItem).
Memories: The number of memories you can create per month (addMemory).
Transfers: The number of items you can transfer per month (transferItem).
| Plan | Items | Memories | Transfers |
|---|---|---|---|
| Plan | Items | Memories | Transfers |
|---|---|---|---|
To ensure stable API performance during sudden increases in traffic, rate limits are used as safeguards. If the rate limiter is triggered by your request, the request will return an error. We suggest handling rate limit errors by incorporating a retry mechanism with exponential backoff.
The specific rate limits can vary depending on the plan and are detailed below. The limits are measured in terms of the allowed number of requests per second (RPS).
| Plan | Requests | Storage* |
|---|---|---|
| Plan | Blockchain | Non-blockchain |
|---|---|---|
Free
20
20
Seed
100
100
Growth
1000
1000
Free
20
20
Seed
100
100
Growth
200
200
Free
10,000
0.1 GB
Seed
100,000
1 GB
Growth
1,000,000
10 GB
Free
4 RPS
4 RPS
Seed
4 RPS
4 RPS
Growth
4 RPS
4 RPS